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Basics 


This chapter, as its title suggests, contains basic information on work- 
ing with SynthKit - things that you’ll need to know before you start 
making sounds. 


Please pay special attention to the first section, “Before You Begin,” 
which details the hardware and software required to run SynthKit. 
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hardware and software 


Before You Begin required by SynthKit 


Hardware & OS 


For SynthKit to run properly, you must be using a supported computer, 
with certain pieces of hardware and software installed. 


Please note the particular setup requirements for OMS. 


MacOS PowerPC Required 


SynthKit requires a MacOS computer with a PowerPC processor. 


MacOS System 8.0 Required 


You must be running System 8.0 or higher on your Macintosh. 


DSP platform 


SynthKit requires one or more digital signal processors (dsps) to pro- 
duce sound. SynthKit is a dsp compiler, and as such is designed to be 
able work with a number of different dsps, which have in the past 
included the Motorola 56000, TI 57002, and Korg proprietary dsps. 


The current version concentrates on support for the Motorola 563000 
series, in support of the OASYS PCI. 


Note that the correct dsp Module should be selected at the top of the 
Commands menu, and that various blocks may function differently (or 
not at all) on different dsp platforms. 


NOTE: Some blocks may work ina slightly different way on different 
hardware platforms. For more information on this topic, see the Host & 
DSP Specifics chapter. 


Disable Virtual Memory 


As with most real-time audio applications, virtual memory is not 
advised for use with SynthKit. Make sure that this feature is turned off 
in the Memory control panel. 


As Grand Master Flash said, “Don’t Do It!” 


MIDI Interface and MIDI Controller 


To play sounds you must have a MIDI controller, such as a keyboard or 
wind controller, and a MIDI interface to connect the controller to the 
Macintosh. 


OMS Setup - Please Note! 


SynthKit includes basic support for the Open Music System. The pro- 
gram has specific requirements, however. To be recognized, the control- 
ler must be named “Modem.” 
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using MIDI notes 
in SynthKit 


MIDI Note to Pitch 


In many ways, SynthKit is similar to the early modular synthesizers 
built by Moog, E-mu, and other pioneering companies. As in those 
patchcord-laden instruments, very few connections are “hard-wired;” 
you are free to route audio and modulation signals almost anywhere 
you choose. This is extended to many modulation routings which we 
have come to assume as fixed - such as note number to pitch. 


You must use a System Receive block to route MIDI notes to the pitch of 
a SynthKit Block, such as an Oscillator or Cylinder. After receiving the 
note number, you will usually need to run it through a table; depending 
on the block to be receiving the note number, one of several tables 
should be used. 


Usually, blocks expect MIDI note numbers in exponential form. Note 
should be run through the constant table cExponentialNote for control- 
ling table-based blocks such as Hammers, Oscillators, and Glottals, and 
also for modulating Filters. For controlling cylinder-based blocks, such 
as Tubes and Cylinders, the constant table cExpLength2000 should be 
used; for delay-line blocks, use the constant table cExpLength1000. 


When another controller - such as Pitch Bend - will also be modifying 
pitch, it should be merged with MIDI notes before the table (you can 
use a Mixer block to do this). You'll probably want to use the Mixer to 
scale the controller’s gain - for Pitch Bend, scaling to 0.09375 (12/128) 
yields a range of an octave. 


After merging the two signals, convert the sum to exponential form 
with the appropriate table. 


Basics 
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Menus 


SynthKit has four main menus, each of which contains commands and 
settings pertaining to a particular aspect of the program. Some of the 
menus contain submenus (marked by a ( > ) to the right of the selec- 
tion), which offer their own sets of related commands. 
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File Menu 


New (3€N) 
Open...(3= O) 


Import... 


open, save, import, or print a 
file; preferences, file utilities 


SynthKit’s File menu contains options and commands for opening, 
saving, importing, and printing SynthKit files, the preference settings, 
and the Batch command, which allows you to carry out certain repeti- 
tive tasks automatically. 


This creates a new, empty file. 


This brings up a modified Macintosh open file dialog box, allowing you 
to open a previously created file. Multiple documents may be open at 
one time, within the limitations of your Macintosh’s memory and the 
memory allotted to the SynthKit program. 


Stationery Pads 


SynthKit supports System 7’s stationery pads, allowing you to create 
templates which can’t be accidentally overwritten. To make a file into a 
stationery pad, close the file in SynthKit and go to the Finder. Select the 
template file in the Finder, and choose “Get Info” from the File menu. 
Click the “Stationery Pad” check box in the lower left-hand corner of 
the Info window, and then close the window. The next time the file is 
opened in SynthKit, it will be opened as “Untitled,” prompting you to 
save it under a new name. 


File Type Check Boxes 


SynthKit can read data from a number of different file types. When 
opening files, you can filter the list so that it shows only the file types 
that you’re interested in. Only file types which have been checked will 
be shown (you can change these settings at any time). 


SynthKit. This shows the basic SynthKit file type. 


AIFF. Shows AIFF format Samples (from Alchemy, for example). When 
opened, a new algorithm is created, empty except for the Sample files. 


Sound Designer I. Shows Sound Designer I files. When opened, a new 
algorithm is created, empty except for the Sample files. 


Sound Designer II. Shows Sound Designer II files: When opened, a 
new algorithm is created, empty except for the Sample files. 


SampleCell. Shows Sample Cell instrument files. These can be read 
into multisample maps. Instrument files with velocity splits are not cur- 
rently allowed. The sample files pointed to are searched for 1) in the 
location specified in the instrument file, 2) in the same location as the 
instrument file, 3) where a previous sample file was found, or 4) on the 
same disk as the instrument file. 


Tables Text. Shows Tables stored as text; when opened, these are 
brought into a new, empty algorithm and converted back into Tables. 
Multiple Tables may be stored in a single text file. 


This brings up a variation of the standard Macintosh open file dialog 
box, allowing you to bring MultiTables, Tables, Multisamples, Samples, 
and algorithms from another SynthKit file into the current one. 
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open, save, import, or print a 
file; preferences, file utilities 


FileMenu 


File Type 


SynthKit can read data from a number of different file types. When 
opening files, you can filter the list so that it shows only the file types 
that you’re interested in. Only file types which have been checked will 
be shown (you can change these settings at any time). 


SynthKit. This shows the basic SynthKit file type. Various parts of the 
SynthKit file can be imported; the check-boxes below this one (includ- 
ing Control Panel, MultiTables, Tables, and so on) determines which 
parts will be imported. For more information, see “SynthKit File Import 
Options” below. 


AIFF. Shows AIFF format samples (from Alchemy, for example). 
Importing Tables via Sound Designer II and AIFF seems to map the 
Tables to different base keys. The tuning is off, as well. 


Sound Designer I. Shows Sound Designer I files. 


Sound Designer II. Shows Sound Designer II files. Importing Tables 
via Sound Designer II and AIFF seems to map the Tables to different 
base keys. The tuning is off, as well. The SDII format has no base key or 
tuning, so SynthKit just uses default values. 


SampleCell. Shows Sample Cell instrument files. These can be read 
into multisample maps. Instrument files with velocity splits are not cur- 
rently allowed. The sample files pointed to are searched for 1) in the 
location specified in the instrument file, 2) in the same location as the 
instrument file, 3) where a previous sample file was found, or 4) on the 
same disk as the instrument file. 


Tables Text. Shows Tables stored as text. Multiple Tables may be stored 
in a single text file. 


SynthKit File Import Options 


These check boxes determine the items to be imported when importing 
a SynthKit file. Any or all of these may be checked at a time (but if none 
of them are selected, then nothing will happen when you import the 
file). 


Control Panel. This imports one or more control panels from the 
selected SynthKit file; a dialog box allows you to select which control 
panels should be imported. Control panels can only be imported if the 
slider name and block ids are identical to that of the current file. 


MultiTables. With this option selected, opening a SynthKit file will 
bring up a dialog box, allowing you to select one or more MultiTables to 
be imported from the file. Tables used by the MultiTable(s) will auto- 
matically be imported as well; you don’t need to check the Tables box. 


Tables. If this is checked, opening a SynthKit file will bring up a dialog 
box, allowing you to select one or more Tables to be imported from the 
file. 


MultiSamples. With this option selected, opening a SynthKit file will 
bring up a dialog box, allowing you to select one or more MultiSamples 
to be imported from the file. Samples used by the MultiSample(s) will 
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File Menu 


Close(3é W) 


Save (3S) 


Save As... 


open, save, import, or print a 
file; preferences, file utilities 


automatically be imported as well; you don’t need to check the Samples 
box. 


Samples. With this option selected, opening a SynthKit file will bring 
up a dialog box, allowing you to select one or more Samples to be 
imported from the file 


Algorithm. If this box is checked, opening a SynthKit file will bring up 
a dialog box, allowing you to select an algorithm to be imported from 
the file. Only one algorithm can be imported at a time, and the root 
algorithm cannot be imported. After selecting the algorithm to import, 
a second dialog box will appear, allowing you to change the name of 
the imported algorithm. 


Importing an Algorithm will not automatically import Tables or Sam- 
ples used by the Algorithm; you must be sure to import any necessary 
Tables separately. 


If the imported Algorithm has any sliders, they will appear on all Con- 
trol Panels in the current file. To ensure that the Algorithm is initialized 
with the appropriate slider values, select the Specify command from 
the Control Panel window’s Commands menu. 


Block. This does not do anything, currently. Importing an Algorithm 
will always import the necessary blocks as well. 


This closes the current file. If you have not yet saved the file, a dialog 
box will automatically appear, allowing you to do so. 


This saves the current file to disk, using the same name and folder loca- 
tion. If you use this command with an unnamed, new file, the Save As... 
dialog will appear, allowing you to name the file. 


This allows you to save a file with a different name, in a different folder, 
or on a different disk. Use this command to store variations of a file, or 
to make backups from within SynthKit. 


File Type 


This allows you to simply store the entire file (by selecting the SynthKit 
file type), or to save parts of the data such as Samples, Tables, and so on 
into various special (or not so special) formats. 


SynthKit. This is the basic SynthKit file type. Unless you're doing 
something special, use this format. 


AIFF. Saves the selected Sample as an AIFF file (for Alchemy). 
Sound Designer I. Saves selected Sample as an SD I file. 
Sound Designer II. Saves selected Sample as an SD I] file. 


SampleCell. Saves selected MultiSample as a Sample Cell instrument 
file. 


Tables Text. Creates a text file with the name, length, and data of all 
Tables in the document. Multiple Tables will still be stored in a single 
text file. The Tables text format consists of: 1) a single-quoted Table 
name, 2) an optional single-quoted comment, 3) decimal length, 4) car- 
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open, save, import, or print a 


file; preferences, file utilities Fi fi e M enu 


riage return, and 5) data separated by commas, with optional carriage 
returns. 


Text. Saves the main document window as a text file. 


Revert to Saved This closes the current file without saving, and loads the old version of 
the file from the disk, effectively discarding all changes since the last 
save. 

Save Setup Saves the current window positions and module signature, so that sub- 


sequent new files will be configured to your preferences. The module 
signature is also saved with preferences. 


Preferences You can customize your SynthKit environment in many different ways; 
the Preferences allow you to set the default values for many parame- 
ters. 


General. These are basic parameters of the SynthKit environment. 


Open New On Startup. Each time the program is run, it will 
come up with a new, blank document. 


Run On Activate. The current document is stopped when you 
click in a window from another document. If the new document 
was running previously, and the preferences run on activate flag 
is TRUE, the new document is run. 


Speed Of Sound. This sets the speed of sound for SynthKit’s cal- 
culations, in meters per second. If you need to hear what your 
algorithm will sound like under water, or on the moons of Jupi- 
ter, set this parameter accordingly; otherwise, you might just 
leave it at the normal setting of 330. 


Number of Digits. This is the number of digits used for parame- 
ter displays. 


Parameter Limit. This is also used for the parameter display for- 
mats - for instance, to set them to a range of 1 to 100. The mini- 
mum value is 1. 


Enable MIDI. When this box is checked, SynthKit will connect to 
the MIDI system (e.g. OMS) to allow realtime control from MIDI 
keyboards and other MIDI instruments. After setting this param- 
eter, you must re-start SynthKit for the change to take affect. 


Ticks. This page sets how often SynthKit’s different windows are 
polled for mouse clicks - power user parameters, indeed. 1 Tick = 1/60 
of a second. The Control Panel parameter is probably the most useful. 


Document Ticks. This sets the polling frequency for the Docu- 
ment window. 


Table Ticks. This sets the polling frequency for Table windows. 


Sample Ticks. This sets the polling frequency for Sample win- 
dows. 


Control Panel Ticks. If this is set to a low value, meter displays 
will be faster - but it will also use more host horsepower. It’s 
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File Menu 


open, save, import, or print a 
file; preferences, file utilities 


entirely up to you. 
Process Time Ticks. This sets the polling frequency for the Pro- 
cess Time meters. 


Algorithm Ticks. This sets the polling frequency for Algorithm 
windows. 


Block Ticks. This sets the polling frequency for Block windows. 


Show ID. All objects in a file, including Algorithms, Blocks, Tables, 
Samples, etc., have a unique ID number. These parameters determine 
whether or not this ID number is displayed on the screen. 


Show MultiTable ID. This is normally shown in the MultiTable 
List window, to the left of the name. 


Show Table ID. This is normally shown in the Table List window, 
to the left of the name. 


Show MultiSample ID. This is normally shown in the MultiSam- 
ple List window, to the left of the name. 


Show Sample ID. This is normally shown in the Sample List 
window, to the left of the name. 


Show Algorithm ID. This is currently unused. 


Show Block ID. This is normally shown to the left of the name in 
the algorithm window. 


Check. This will make sure that the selected text fields (names and 
comments) actually have text entered into them; this will probably be 
important for final voicing on whatever undisclosed, unnamed prod- 
ucts might emerge... 


Control Panel. These preferences affect the behavior of the Control 
Panel. All values are in pixels, unless otherwise specified. 


Vertical Item Width. This sets the default width for control panel 
items. 

Label Width. This sets the default width of the text label for the 
item. 

Slider Length. This sets the default length of sliders. This has no 
effect on other types of control panel items. 

Popup Menu Length. This sets the default length of popup 
menus. 

Toggle Button Length. This sets the default length of toggle but- 
tons. 

Small Edit Text Width. This sets the default width of the “small” 
preset for text edit fields. 


Medium Edit Text Width. This sets the default width of the 
“medium” preset for text edit fields. 


Large Edit Text Width. This sets the default width of the “large” 
preset for text edit fields. 
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Default Edit Text Width. This sets the default width for text edit 
fields. 


Horizontal Spacing. This sets the default horizontal spacing 
between control panel items, and the amount used by the Space 
command; normal is 10. 


Vertical Spacing. This sets the default vertical spacing between 
control panel items, and the amount used by the Space com- 
mand; normal is 12. 


Insert System Blocks. This specifies whether or not control panel 
items are automatically added for new system send / receive 
blocks. 


Insert MultiSample Blocks. With this checked, dummy place- 
holders for MultiSample selects will be added to the Control 
Panel. 


Insert MultiTable Blocks. Similar to Insert MultiSample Blocks, 
above, this inserts placeholders for all MultiTable selects. 


MultiTable. This allows you to set which columns of data, and which 
sliders, will be shown in a new MultiTable. These preferences can be 
changed for each MultiTable using that window’s Show menu. 


Table. These preferences affect the behavior of Tables. 


Table Length. This sets the default length of new Tables; 1024 is 
normal. 


Auto Send. When this item is checked, Table edits will be auto- 
matically downloaded to the DSP. 


MultiSample. This allows you to set which columns of data, and which 
sliders, will be shown in a new MultiSample. These preferences can be 
changed for each MultiSample using that window’s Show menu. 


Sample. These preferences affect the behavior of Samples. 


Sample Length. This sets the default length of new Samples; 2000 
is normal. 


Auto Send. When this item is checked, Sample edits will be auto- 
matically downloaded to the DSP. 


Use Minimum Loop Length. If this is selected, Samples are 
checked for minimum loop length as they are imported. 


Minimum Loop Length. The minimum loop length allowed 
when “Use Minimum Loop Length” is selected. 


Execution. This sets the default values for most of the settings in the 
Execution window (for more information on these parameters, see the 
entry for the Execution window on page 66). 


Patch. This sets the default values for a new Patch’s voice allocation 
and pitchbend amount. 


Algorithm. These preferences are for the Algorithm window. 


Close Enough To Rect. This sets the “grace distance” around an 
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icon, so that you can click close to the icon—but not actually on it- 
and still select it. The distance is in pixels. 


Close Enough To Point. Like the parameter above, but for con- 
nection wires instead of blocks. The distance is in pixels. 


Connections Obscure Block Names. When this is enabled, con- 
nection wires will be drawn on top of block names. 


Block Names Obscure Connections. When this is enabled, block 
names will be drawn on top of connection wires. 


Disable Algorithm Undo. When the undo is disabled, all opera- 
tions with the algorithm window will be much quicker. The Edit 
menu will still say “Undo x” and “Redo x,” but they will have no 
affect. 


Short Algorithm Status. This shows the abbreviated version of 
the status line. 


Alphabetize Add Popup. This will alphabetize the add popup, 
which displays a scrolling list of all items in the current page of 
the Algorithm Tolls palette when you option-click in the Algo- 
rithm window. This makes the list easier to read, but it will take 
more time to come up. 


Show Outline. This displays a dotted outline in the upper left- 
hand corner of the algorithm window, so that you can prepare 
algorithms to be shown on smaller screens. 


No Labels. This makes all of the text around the icons invisible 
(including the name, number, etc.). 


Outline Width. This sets the width of the outline. 
Outline Height. This sets the height of the outline. 


Block. This allows you to set which columns of data will be shown ina 
new block. 


Paths. This allows you to set paths for various files related to SynthKit, 
as well as displaying the location of the SynthKit application, the Pref- 
erences file, and the current document. 


Source. This sets the location for source files for the code block. 


Multisamples. This sets the location of the multisample library. 
Press the Choose button to select a new folder. 


Batch allows you to compile a number of files with a single command 
(while you go and get lunch), or to get statistics from the Run Time win- 
dows of a group of files. Use standard file to select a folder, and 
whether or not to make all. All SynthKit files in that directory and on 
down are (optionally) made all and then compiled and saved. 


Aliases for files and folders are supported, but be careful not to create 
circular references (for instance, a folder containing an alias of itself); 
these will cause the program to loop forever, contemplating its navel 
and perhaps eventually reaching enlightenment - but never finishing its 
task.= 
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A text log file named “SynthKit Log” is created in the same directory as 
the SynthKit application. The log lists the directories and files encoun- 
tered, as well as the text from the file’s document window (the error 
string returned from the compile process). 


Compile. Compiles all of the files in the selected directory, using the 
parameters below. 


Make All. Sets the Make flags for all of the blocks in all of the 
files in the selected directory. 


Only Not-Runnable. This option allows you to compile only 
those files which need to be updated for a new version of Synth- 
Kit; all files which do not need updating will be left alone. This 
can save a lot of time for large batches. 


Page Setup... This brings up the standard Macintosh Page Setup dialog box, allowing 
you to set the paper size, orientation, etc. used for printing (see Print, 
below). 

Print... This brings up the standard Macintosh Print dialog box, allowing you 


to print the graphics of the selected window of the current file. Note 
that sliders in the Control Panel and Block windows are not shown cor- 
rectly. 


Quit (36 Q) This quits the SynthKit program. If you have not saved the current 
file(s), a dialog box will appear, allowing you to do so. 


1. What is the sound of one folder looping? 
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Undo (3 Z) 
Cut (32) 


Copy (3 C) 
Paste (3 V) 


Clear 

Duplicate 
Select All (3$ A) 
Rename...(3# =) 


Edit...(3E) 


Icon... 


Grow...(3€ G) 


Ungrow...(3€ VU) 


undo, cut/copy/paste, & other 
object-oriented commands 


The Edit menu provides many of the Macintosh’s familiar editing 
operations, in addition to a number of general-purpose commands. 


“Tt’s a wonderful, object-oriented world.” 
Cancels the last operation performed. 


Deletes the selected item(s), and places them on the clipboard. When 
deleting an item that has been Grown, you should use Ungrow instead. 


Copies the selected item(s) to the clipboard. 

Pastes whatever is on the clipboard, if applicable. 

Deletes the selected item(s). 

Makes a copy of the selected item(s), and places them in the file. 
Selects all blocks and connections in the current Algorithm window. 


Brings up a dialog box to enter a name for the currently selected Sam- 
ple, MultiSample, Table, or MultiTable, or a name for the currently 
selected Page in the Control Panel or any of the List windows. 


The Algorithm Tools window is a floating palette, which (for technical 
Macintosh reasons) cannot have a “current selection.” To edit the name 
of a Page in the Algorithm Tools, double-click on the page number. 


This command brings up the standard editor for the selected item, 
including blocks, Samples and Tables, Control Panel items, and so on. It 
is usually the same as double-clicking on an item. 


Brings up an icon editor for the currently selected block. If you’re really 
serious about your icons, you can also use the more full-featured icon 
editor in Res Edit, and copy and paste the icon onto a block. 


Grow is one of the most frequently-used commands in SynthKit. It is 
used whenever you wish to have more of something, such as ports on a 
block, Tables in a MultiTable, pages in the Control Panel, and so on.4 
Sometimes, an item can be grown in several ways; for instance, a block 
may have several different growable ports. In these cases, a dialog box 
will appear, allowing you to specify what will be grown. 


There are point-and-click shortcuts for Growing block ports and Algo- 
rithm Tools pages. To grow more of a particular port, #§-click on its 
name or icon; to grow another page in the Algorithm Tools palette, just 
6 -click on the page buttons. 


Deletes the selected item (such as a Table in a list), or when there is no 
item selected, deletes the last item in the list. 


As with SynthKit’s other commands, you can always Undo an Ungrow 
if you need to. 


There are point-and-click shortcuts for Ungrowing block ports and 
Algorithm Tools pages. To delete a particular port, option-click on its 


1. There are some cases in which the Grow command doesn’t seem to 
work; for instance, “SynthKit, Grow Money Market Account” does not 
produce the desired results. We are working on this issue and expect to 
reach a solution shortly. 
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name or icon; to ungrow a page of the Algorithm Tools palette, option- 
click on the page buttons. 


Show Clipboard Displays the contents of the clipboard. Cut or copied SynthKit algo- 
rithms will be displayed graphically, just as in the Algorithm window. 
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OASYS PCI 


Commands 


Beep 


Compile...(3## K) 


Run (3 R) 


Stop (367) 


Dsps 


compile and run algorithms 


The Commands menu is used to compile and run algorithms. 


This indicates that SynthKit is being used with OASYS PCI. 


You will probably use the Compile, Run, and Stop commands fre- 
quently; the other commands are provided for diagnostic purposes. 


This makes the Macintosh beep. Just a system beep, that’s all. Come on, 
can’t some of this stuff be simple? 


This command prepares the current algorithm for the current DSP type. 
Every time that you change the wiring of the algorithm, you must com- 
pile again. Other changes may also require you to re-compile; the status 
bar in the Algorithm window displays whether or not compilation is 
necessary. After compiling, a brief report about the compilation will 
appear in the Document window. 


To actually play the algorithm once it has been compiled, you need to 
use the Run command as well. 


Compile preferences may be set on a file-by-file basis in the menu of the 
Execution window (see page 66 for details). 


Depending on the dsp module being used, these preferences can make 
dramatic improvements in the size and efficiency of SynthKit’s dsp 
code; for information on options for specific dsp’s, please see Host & 
DSP notes, on page 231. 


This runs the real-time control routines - so you can play and listen to 
the algorithm. Audio will be faded in according to the ramp times set in 
the audio input and output blocks. 


This stops the real-time control routines on the dsp and host. Audio will 
be faded out according to the ramp times set in the audio input and 
output blocks. 


If you’re editing an algorithm, you can use Stop to free up processing 
power on the Macintosh host - this will often make the program move 
much faster. 


Prints a report in the document window, showing all installed dsps, 
including the sizes of their associated memory areas. 
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Documents 


Standard 
Windows 


Algorithm Tools 


Control Panel Tools 


Constant 


Global 


File-Specific 
Windows 


Control Panel 
MultiTables List 
Tables List 
MultiSamples List 
Samples List 


Execution 


Windows 


SynthKit’s functions are organized into a number of windows, and all 
of the main ones are accessed from this menu. Select a window’s name 
to open it, or to bring it to the front if it’s already open. 


The top section of the menu shows the names of all open SynthKit files. 
The current file is marked by a check-mark. Selecting a file’s name 
makes it current, and brings its Document window to the front. 


These windows apply to all open documents. 


Opens the Algorithm Tools palette. This is a floating palette; it will 
always be displayed on top of a normal window. For more information 
on the Algorithm Tools, please see page 38. 


Opens the Control Panel Tools palette. Like Algorithm Tools above, this 
is a floating palette; it will always be displayed on top of a normal win- 
dow. For more information on the Control Panel Tools, please see page 
63. 


This contains hierarchical selections for the Constant Tables List, Sam- 
ples List, MultiTables List, and MultiSamples List windows. For more 
information on the Constant lists, please see page 45. 


This contains hierarchical selections for the Global Tables List, Samples 
List, MultiTables List, and MultiSamples List windows. For more infor- 
mation on the Global lists, please see page 68. 


These windows are part of the individual files; each SynthKit file has its 
own Tables List, for instance. SynthKit will open the window from the 
current file. 


Opens the Control Panel for the current file. For more information on 
the Control Panel, please see page 63. 


Opens the MultiTables List for the current file; for more information on 
this window, look to page 77. 


Opens the Tables List for the current file; please see page 95 for more 
information. 


Opens the MultiSamples List for the current file. For more information 
on this window, please see page 73. 


Opens the Samples List for the current file; look to page 86 for more 
information. 


Opens the Execution window for the current file; for more information 
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Comment 
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on this window, please see page 66. 


Opens the Patch window for the current file. Please see page 79 for 
more information on this window. 


Opens the Run Time window for the current file. For more information 
on this window, please look to page 80. 


Opens the Process Time window for the current file; please see page 79 
for more information. 


Opens the Comment window for the current file; for more information 
on the Comment, please see page 44. 


The bottom section of the menu shows all of the Patches and Algo- 
rithms in the current file, including the root Patch (the top-level algo- 
rithm window). You can use this to open a nested algorithm directly, 
without needing to open all of its parent windows. 
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SynthKit’s functions are organized into a number of different windows. 
This chapter lists each of the windows in alphabetical order, and 
explains each of their functions in detail. 
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Working with 


Algorithms 


Algorithm 


The Algorithm window is the heart of SynthKit; it is used to create and 
modify SynthKit algorithms. In this window, you can place different 
blocks into an algorithm, connect those blocks together with wires, and 
open the blocks to edit their internal parameters. 


Placing & Moving Blocks 


To select a block to add to the algorithm, click on its icon in the Algo- 
rithm Tools window. Move the cursor back into the Algorithm window; 
notice that its icon changes from the arrow to the word, “Block.” Place 
the block by just clicking on the desired spot in the window. Command- 
clicking lets you place multiple copies of the same block (see under 
Shortcuts below). 


You can move blocks around in the window; this is handy for cleaning 
up the appearance of an algorithm. Any connections that you have 
made to the block will be maintained properly. To move a block, just 
click to select it and then drag it to the new location (you'll see an out- 
line of the block as you move it around). If multiple blocks are selected, 
dragging any one of them will move all of them together. You can also 
use the arrow keys to move blocks in any direction, a single pixel at a 
time. 


You can select multiple blocks by shift-clicking on them one at a time, 
or by clicking on an empty spot in the window and dragging a selection 
rectangle around the desired blocks. Additionally, command-A will 
select all blocks in the window. 


You can add a block between two existing blocks (such as adding a fil- 
ter to an algorithm after an oscillator and before a mixer), and have 
some of the connections made automatically. To do this, select the tool 
and then option-click on the connection wire; the block will be inserted 
into the connection, with a single input and a single output port hooked 


up. 
Copying & Pasting Blocks 


You can copy and paste blocks, or groups of blocks, within a document 
or between different documents. (One exception is connection input 
and output blocks, which cannot be copied or pasted.) 


Control Panel items and referenced tables and multitables are copied 
along with blocks. 


After pasting, you may need to adjust the position of the blocks and 
Control Panel items. Blocks will generally be pasted into the center of 
the window, and may be in the same position as existing blocks. Newly 
pasted blocks remain selected, however, which allows you to use the 
arrow-key shortcuts to move them to an un-obscured location in the 
window. 


Windows 
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Control Panel items will be pasted below all existing items. You may 
need to scroll down in order to see them; if so, just select them and 
move them to the desired location. 


Making Connections 


To connect two ports, just click on one and then drag to the other. It 
doesn’t matter which one you click on first. Inputs can only be con- 
nected to outputs, and vice versa. 


With an Algorithm or Patch block, dragging the end of a connection 
wire into the middle of the block will create a new port of the appropri- 
ate type (input or output). Dragging a wire onto a growable port which 
is already connected to something else will cause a new port to be 
grown; the connection will be made to the new port. 


On the block icons, port types are distinguished by their shape (which 
shows whether the port is on the host or the dsp, and whether it uses 
continuous or enumerated values) and their being filled or unfilled 
(which shows whether the port is for input or output). 


Continuous ports use continuously variable values, such as floating- 
point numbers; dsp continuous ports are square, and host continuous 
ports are round. 


Enumerated ports, on the other hand, accept integer values only; these 
are shown as triangles for the dsp, and as diamonds for the host. All of 
these port types can be either input or output ports; for input ports, the 
shape is hollow, and for output ports, the shape is filled in. 


Sometimes, a connection wire will cross over a block name, and the two 
will fight it out for screen space. You can use the Algorithm page of the 
Preferences command (on the File menu) to choose whether the name is 
drawn over the line, or vice-versa. 


An even better solution is to create breakpoints in the connection (by 
option-clicking and dragging the wire), to bend the wire around the 
block. For more information on connection breakpoints, see under 
Algorithm Cosmetics below. 


Editing Blocks 


To edit a block’s low-level parameters, you can double-click on the 
block, command-click on the block, or select the block and then choose 
Edit Block from the Block menu. All of these actions will open up the 
Block window, which allows you to view and edit the parameters. 


The Algorithm and Patch blocks work slightly differently; double-click- 
ing opens another Algorithm window, so that you can view and edit 
the blocks inside. Command-click and Edit Block still allow you to edit 
the block parameters. 


Algorithm and Patch Blocks 


These two blocks are special, in that they can contain any number of 
other blocks. Double-clicking on these blocks opens up a new Algo- 
rithm window, allowing you to view the blocks within the Patch or 
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Algorithm 
Cosmetics 


Algorithm 


Algorithm. 


(If an algorithm is password-protected, double-clicking will open the 
Algorithm’s Block window. Command-clicking will open the Algo- 
rithm window, after the required password has been entered.) 


Algorithms can themselves contain other Algorithms. 


You can approach creating a Patch or Algorithm in one of two ways. 
The first is simply to start by creating the Patch or Algorithm, and then 
open it up and start placing blocks and making connections. The alter- 
native is to work within the main algorithm, and then to select a num- 
ber of blocks and choose the Merge command from the Block menu. 
This will create a new Patch or Algorithm from the selected blocks. 


Algorithms and Patches use the connectionInput and connectionOut- 
put blocks to create ports. If you merge a set of blocks which contain 
connections to others not being merged, the necessary connection 
blocks will be created for you. If you want to add more inputs and out- 
puts to the Algorithm or Patch, simply place more connection blocks 
manually. 


You can also simply drag from any port onto the Algorithm or Patch 
block, as if you were making a connection between two ports, and a 
port (and its corresponding connection block) will be added automati- 
cally. 


If the option and control keys are held down when adding an Algo- 
rithm or Patch block, you can import an algorithm from another Synth- 
Kit file (you can also import algorithms from the File menu). 


Stop Before Changing Blocks or Connections 


If you’ve been running an algorithm, it’s a good idea to choose Stop 
from the Commands menu (#8T) before adding blocks, changing con- 
nections, etc. Editing the algorithm as it’s running will still work, but 
operations will be much slower. 


On the other hand, if you’ re just editing control panel parameters, port 
values, etc., you should leave the algorithm running. 


SynthKit algorithms can become quite complex; you can easily end up 
with a zillion! blocks and wires running every which way, and an algo- 
rithm that’s even difficult for the designer to decipher. With just a little 
attention to layout and visual organization, though, algorithms can 
become much easier to comprehend. 


SynthKit offers a lot of tools to help you out with algorithm cosmetics. 
You can use breakpoints to clean up your wiring, for instance, as 
described below. Control- 3-dragging on a port icon allows you to 


1. A technical term, meaning “many.” Less than a jillion, though. 
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move the port to a new position on the block; while you can do this for 
all blocks, it’s only recommended for user items such as merged algo- 
rithms (so that the port placement of standard blocks remains consis- 
tent). 


You can use the Block menu’s Merge command (3€-M) to place a group 
of blocks within a sub-algorithm, for a better conceptual organization of 
the algorithm as a whole. For instance, you could take all of the blocks 
relating to an analog algorithm’s filter (the envelope, lfo, other modula- 
tion routings, and the filter itself) and merge them into a single algo- 
rithm block named “Filter Section.” 


The Algorithm page of the Preferences dialog (in the File menu) has 
several options for controlling the appearance of algorithms; see the 
entry under “Menus” for more information. 


You can edit the icon of a block, or an icon object in the Control Panel, 
by selecting Icon... from the Edit menu. For a more sophisticated set of 
icon editing tools, you can use ResEdit to create an icon, copy it, select a 
SynthKit block, and then simply Paste; the icon will be pasted into the 
block. Be careful when copying icons from sources other than ResEdit; 
most applications copy icons as the file type PICT, but SynthKit 
requires the type ICON. 


Breakpoints 


Wires don’t need to be straight-line connections between two ports; you 
can create a number of intermediate points at which the wire changes 
direction, called breakpoints. This can make connections easier to see, 
and visually clean up an algorithm. 


To create a breakpoint, just option-click on a wire and drag to create an 
angle. Wires can have multiple breakpoints, if you like. You can select 
an existing breakpoint by clicking on it, and then drag to change the 
angle as desired. To delete a breakpoint, select it and press Clear or 
Delete. A line segment between two breakpoints may be moved with- 
out changing its slope (so that both it and its two connecting break- 
points move together); to do this, just click on that part of the line and 
drag. Line segments which connect to ports can’t be moved in this way. 


Block 


We should mention the switched behavior of password 
protected patch and algorithm blocks here (double and # 


click switched) 


For almost all blocks, this opens the Block window, for the selected 
block, allowing you to edit the low-level parameters. The only excep- 
tions are the Patch and Algorithm blocks, in which double-clicking 
opens up an Algorithm window instead, allowing you to see the blocks 
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Opt-Click w/BLOCK Cursor 


Shift-Click 


Return or #8 Click 


Control-Click 


Option-Click & Drag 


Arrow Keys 
38 Arrow Keys 


Home 

End 

Page Up 
Page Down 


Delete Key 


BBG 


Algorithm 


inside. To edit the parameters of a Patch or Algorithm, use command- 
click, as noted below. 


(If an algorithm is password-protected, double-clicking will open the 
Algorithm’s Block window. Command-clicking will open the Algo- 
rithm window, after the required password has been entered.) 


Selects the block without de-selecting other blocks. You can thus select 
a number of blocks by shift-clicking on each of them, one after another. 
If a block is already selected, shift-clicking de-selects it. 


Either of these techniques opens the Block window for all blocks, 
including Patch and Algorithm. This is the same as using the Edit Block 
command in the Block menu. 


(If an algorithm is password-protected, double-clicking will open the 
Algorithm’s Block window. Command-clicking will open the Algo- 
rithm window, after the required password has been entered.) 


Brings up a menu allowing you to select where and how the block is 
run - on the Dsp, or at one of several host rates. This is the same as 
using the Type menu in the Block window. 


Makes a copy of the selected block(s). To make a copy of two or more 
blocks, select them by using shift-click and then option-click on any of 
the already selected blocks. 


When a new tool has been selected from the Algorithm Tools palette, 
and the cursor arrow is therefore changed to the BLOCK icon, option- 
clicking on a block will replace it with the new selection. Connections 
are preserved as much as possible. 


The arrow keys allow you to move the selected block(s) one pixel at a 
time. 


Move the selected block(s), locking to the grid size set in the Block 
menu’s Align dialog. 


Select the first block in the order of execution. 
Select the last block in the order of execution. 
Select the previous block in the order of execution. 
Select the next block in the order of execution. 


Deletes the selected block(s). This is the same as selecting Clear in the 
Edit menu. 


Brings up the Grow dialog box for the currently selected block, allow- 
ing you to add more ports, etc. Select the dimension to be grown; some 
blocks may be grown in several different ways (for instance, number of 
inputs and number of outputs). The Times field allows you to grow the 
selected dimension any number of times (well, not any number - try 
sticking to less-than-infinite integers, for a start). 


Brings up the UnGrow dialog box for the currently selected block. 
Select the dimension to be ungrown, and use the Times field to ungrow 
twice or more at once. 
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Double-Click 


Control-Click 


HE Click 
Option-Click 


Control- #6 -Click 


Control-Option-Click 


Shift-Click 


Delete Key 


Control-Option-Click 


Option-Click 


Option-Click with Block Tool 


#8 Click 


Option-Click 
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Port 


Opens the port parameters dialog box, allowing you to set min and 
max values, port position, etc. This is the same as clicking on the port 
name in the Block window. 


Select port type. Brings up a menu allowing you to select whether the 
port is Continuous or Enumerated. 


Grows one more of the selected port. 


Un-Grows the selected port. Un-Grow will have no effect if the block 
has not already been Grown. 


Allows you to move the port to a different position on the block, simply 
by dragging it with the mouse. 


This brings up menu to select port's host flag: either “Block” (default) 
or “Host” (force the port to be on host). 


Connection Wire 


Selects the connection wire without de-selecting other wires. You can 
thus select a number of wires by shift-clicking on each of them, one 
after another. If a wire is already selected, shift-clicking de-selects it. 


Deletes the selected connection wire(s). This is the same as selecting 
Clear in the Edit menu. 


Selects the connection wire on top of a block. For instance, sometimes 
you can see a wire crossing over a block; ina really dense algorithm, 
this may be the only place that the wire is visible. Normally, clicking 
anywhere on a block will select the block. Control-option-clicking will 
select the wire instead. 


Creates a breakpoint in the wire. With breakpoints, wires do not need to 
be a straight-line connection between two ports; you can create a num- 
ber of intermediate points at which the wire changes direction, to bend 
it around blocks. This can make the connections easier to see, and visu- 
ally cleans up the algorithm. 


Inserts the selected block into the connection, hooking up a single input 
and a single output. 


General (Clicks In Space) 


These command-click combinations work when you click on blank 
space in the Algorithm window. “Clicks In Spaaaaaaace...” 


If you have selected a block from the Algorithm Tools window, com- 
mand-clicking will allow you to place multiple copies of the block. 
Note that the cursor stays in the “BLOCK” shape. After you’ve placed 
all the desired copies of the block, use control-click to clear the cursor 
and return it to the default state (you can also just click on the arrow 
icon in the Algorithm Tools window). 


This calls up a pop-up menu of all the blocks in the Algorithm Tools 
window. Selecting a block from the list will place that block in the algo- 
rithm. The list may take some time to appear; just hold down the mouse 
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Control-Click 


Algorithm Menu 


Locked 


Snap To Grid 


Password... 


Edit Make... #6\ 


Make 


Unmake 


Algorithm 


until it does so. This can be made much faster if the Alphabetize Add 
Popup parameter, in the Algorithm page of the Preferences dialog box, 
is unchecked. 


Returns the cursor to the default state after using command-click to 
place multiple copies of the same block, as described above. 


Locking an algorithm prevents blocks from being selected, and thus 
from being edited. Selecting this item puts a check-mark next to it in the 
menu; selecting it again will Unlock the algorithm and remove the 
check-mark. 


Uses the grid parameters as set in the Align dialog box. This is only 
used for dragging icons with the mouse; you can still use the arrow 
keys to “nudge” blocks one way or another (if you really want to...). 

If you like, you can enter a password to protect your algorithm from 
prying eyes (as you type, the letters will all appear as “e”). To guard 
against typing errors, you must enter the password twice, into both the 
main field and a second “Confirm” field. 


When opening a password-protected algorithm, a dialog box will 
appear, asking you to enter the password; again, as you type, all letters 
will appear as “°.” Entering an incorrect password will put up a dialog 
with the message, “Algorithm access denied,” and will not allow open- 
ing of the Algorithm window. 


To un-protect an algorithm: 


1. Open the Algorithm window, using the password as usual (you 
must know the previous password in order to un-protect the algo- 
rithm). 


2. Choose the Password command from the Algorithm menu. 


The text fields for the password will be blank. SynthKit regards a 
blank Password as the same as having no Password at all, so 
simply click “OK” to enter this as the Password, and voila - the 
algorithm is once again un-protected. 


This brings up a dialog box showing the current make status of all 
blocks in the algorithm - i.e., whether or not they need to be compiled. 
You shouldn’t need to use this function very often. 


The “make” is the time-consuming part of the compile process. If you 
like, you can select a block, or a group of blocks, and “make” them indi- 
vidually - without doing any other recompilation. In general, you 
shouldn’t need to use this function very much. 


This will cause the selected block(s) to be made at the next compile, 
whether they need it or not. Again, not for everyday use. 


1. Why the cryptic command key? Says Mr. O’Connell (gleefully), 
“Because it’s the same one as used in Think C™, that’s why!” 
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Find Name... 
Find Type... 

Find System... 
Find Parent 

Find User Send 
Find User Receive 


Find Again... 38, 


Block Menu 
Edit Block... 


Align... 
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Each block, Sample, Table, etc. in a file has a unique ID number. This 
command will search for a block with a specific ID. Error messages 
often provide an ID number if a block is causing a problem; this com- 
mand can be used to find the offending block. 


Find a block with the given name. The dialog box allows you to specify 
all blocks, or just algorithm, send, receive, or control panel blocks. 
Find blocks based on their execution rate: dsp, host demand, or host 1-4 
rates. 


Find the first System Receive block set to a specific event: Note, Gate, 
etc. Use Find Again, below, to locate multiple occurrences. 


If the current Algorithm window is showing a nested algorithm, this 
finds the parent Algorithm or Patch block. 


When a User Receive block is selected, this finds the User Send block 
that it’s listening to. 


When a User Send block is selected, this finds the first User Receive lis- 
tening to the Send. Use Find Again, below, to locate multiple Receives. 


Repeats the last find command, to find the next block meeting the 
search criterion. 


This opens up the edit window for the currently selected block, just like 
double-clicking on the icon. 


Align will automatically adjust the positions of the selected blocks hori- 
zontally and/or vertically, to ease the creation of “clean” looking algo- 
rithms (“Oooh, what nice algorithms, Marge!” “Yes, and look at the 
shine!”). This selection brings up a dialog box with a number of set- 
tings, as described below. 


Horizontal 


Use Grid. If this box is checked, blocks will be horizontally aligned to a 
user-specified grid. Enter the desired grid size (in pixels - 10 is the min- 
imum size). The part of the block matched to the grid (right side, left 
side, or center) is set by the none/right/left/center radio buttons. 


none. Horizontal position will remain unchanged when this option is 
selected. 


left. Blocks will be horizontally aligned by their left sides. 
center. Blocks will be horizontally aligned by their center points. 


right. Blocks will be horizontally aligned by their right sides. 


Vertical 


Use Grid. If this box is checked, blocks will be vertically aligned to a 
user-specified grid. Enter the desired grid size (in pixels - 10 is the min- 
imum size). The part of the block matched to the grid (right side, left 
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Number... 3B 


Auto Number 


Flip Horizontal 


Flip Vertical 


Rotate... 


Space 


Block Type... 


Algorithm 


side, or center) is set by the none/top/bottom/center radio buttons. 


none. The Align command will not affect vertical position when this 
option is selected. 


top. Blocks will be vertically aligned by their top sides. 
center. Blocks will be vertically aligned by their center points. 
bottom. Blocks will be vertically aligned by their bottom sides. 


This menu selection allows you to change the numbering of a specified 
block, or of an entire algorithm. Block numbering is important to the 
order of operations; for more information, please see “Block Number- 
ing” on page 104. 

Change Number. This selection brings up a dialog box which enables 


you to manually change the number of the selected block. Type in the 
desired number and press “Okay.” 


SynthKit will automatically renumber the blocks of an algorithm for 
you. 


Position. This option re-numbers the selected blocks, starting at the left 
and working to the right. If two or more blocks are in the same horizon- 
tal position, renumbering starts at the top and works to the bottom. 


Stream. This option is not yet available. It will eventually renumber 
blocks according to their connections, to help avoid order-of-operation 
difficulties. 


Flips the horizontal orientation of the selected block’s icon and ports. It 
may be used (along with Flip Vertical, described below) to clean up 
algorithms, avoiding the phenomenon of wires crossing over icons. 
This command only changes the way in which the block is displayed; it 
does not change the connections to the block, or any of its functions. 


Flips the selected block’s ports vertically - unlike Flip Horizontal, the 
icon itself remains unchanged. As described above, this only changes 
the appearance of the block, and not its functions. 


This actually changes the port locations. A dialog box appears, allowing 
you to select in which direction the block will be rotated. 


Clockwise. This rotates the selected block clockwise. 
Counterclockwise. This rotates the selected block counterclockwise. 


Evenly spaces ports on the selected block. Use this to clean up if you’ve 
been dragging ports around. 


This option allows you to change the ports of all selected blocks to the 
specified type. This setting determines whether a block is executed on 
the host or the DSP, and is only available for blocks which are capable 
of running on either. 


Dsp. The block will be executed on the Dsp, for maximum resolution 
and speed. 


Host Demand. The block will be executed on the Host as needed. For 
instance, a math block processing controller data only needs to work 
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when the controller is actually moved; most of the time it can lie dor- 
mant. The Calculations menu within the block determines the update 
rate when the block is being used - for instance, when that controller is 
moved, how fast are its values updated. 


Host 1. The block will be executed on the Host (the Macintosh), using 
the Priority 1 update speed, as set in the Execution window. 


Host 2. The block will be executed on the Host, using the Priority 2 
update speed, as set in the Execution window. 


Host 3. The block will be executed on the Host, using the Priority 3 
update speed, as set in the Execution window. 


Host 4. The block will be executed on the Host, using the Priority 4 
update speed, as set in the Execution window. 


This command allows you to select a number of pre-existing blocks and 
merge them into either an Algorithm or a Patch. All existing connec- 
tions will be maintained; SynthKit will automatically add connectionIn- 
put and Output blocks if necessary (see below for details). 


Select all the blocks that you’d like to merge together, and then invoke 
the Merge command. A dialog box will ask whether you wish to create 
an Algorithm or a Patch; after you OK your choice, another dialog will 
appear, allowing you to name the new merged block. 


How are connections maintained? 


Here are a few more comments on maintaining connections after the 
Merge. First, if there are multiple destinations within the algorithm that 
come from the same port (outside the algorithm), only a single input 
port is allocated, and within the nested algorithm, multiple connections 
are made from a single connection input block. 


Second, if there are multiple destinations outside the algorithm that 
come from the same port (inside the algorithm), only a single output 
port is allocated, and within the nested algorithm, only a single connec- 
tion is made to the connection output block. Multiple connections are 
made outside the algorithm. 


Third, the same block objects are used for the nested algorithm so that 
editors and control panels are not disturbed. That is, a block inside the 
nested algorithm should have the same id as original selected block in 
the group to be merged. 


This allows you to pull all the blocks out of a merged Algorithm or 
Patch, and put them back on the main algorithm level. SynthKit main- 
tains all connections properly. 


This adds the selected System Send /Receives, and any MultiTables or 
MultiSamples within the selected blocks, to the Control Panel. The Con- 
trol Panel section of the Preferences dialog has options to automatically 
add these to the Control Panel as they are placed in the algorithm; this 
option allows you to add them manually, on a case-by-case basis. 


This places the selected Algorithm block on the current page of the 
Algorithm Tools palette. You can use this for quick access to commonly 


36 


Version 4.0, January 2000 Windows 


graphically edit . 
SynthKit algorithms A i go rit h m 


used sub-algorithms, such as one which merges MIDI Notes with Pitch 
Bend. 


Connection 
Menu 


Horizontal 


Use Grid. If this box is checked, connections will be horizontally 
aligned to a user-specified grid. Enter the desired grid size (in pixels). 
The part of the block matched to the grid (right side, left side, or center) 
is set by the none/right/left/ center radio buttons. 


none. Horizontal position will remain unchanged when this option is 
selected. 


left. Blocks will be horizontally aligned by their left sides. 
center. Blocks will be horizontally aligned by their center points. 


right. Blocks will be horizontally aligned by their right sides. 


Vertical 


Use Grid. If this box is checked, blocks will be vertically aligned to a 
user-specified grid. Enter the desired grid size (in pixels). The part of 
the block matched to the grid (right side, left side, or center) is set by 
the none/top/bottom/center radio buttons. 


none. The Align command will not affect vertical position when this 
option is selected. 


top. Blocks will be vertically aligned by their top sides. 
center. Blocks will be vertically aligned by their center points. 


bottom. Blocks will be vertically aligned by their bottom sides. 
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This window is a palette containing all of SynthKit’s synthesizer build- 
ing blocks, such as cylinders, filters, oscillators, and envelopes. Each of 
these blocks are described in detail in the “Blocks” chapter of this man- 
ual. 


When you select a block, its name is shown in the status line at the top 
of the window, and the cursor becomes “loaded” with that block. To let 
you know when the cursor is loaded, its icon will change from an arrow 
to “BLOCK” when moving over an Algorithm window. Clicking in an 
Algorithm window will then add the selected block. Option-clicking on 
an existing block will replace it with the selection, preserving any exist- 
ing connections as much as possible. 


The algorithm tools are saved in the preferences file, so they will stay 
the same across all of your files. 


Creating user-defined tools 


To create a user-defined tool: 
1. Create the algorithm block you'd like to install. 


Before installing, you will probably want to edit the block’s icon (so that 
it’s unique and recognizable in the Algorithm Tools palette), and give it 
an appropriate name. 


2. Select the block to install as a tool. 


If more than one block is hilighted, only the first to have been selected 
will be installed. 


3. Select “Install As Tool” from the Algorithm window’s Block 
menu. 


The block will be added to the bottom of the current page in the Algo- 
rithm Tools palette. 


Deleting user-defined tools 
To delete a user-defined tool: 


1. Double-click on any tool in the Algorithm Tools window. A dia- 
log box will appear. 


2. Select the user-defined tool that you'd like to delete. 


Press the Delete button, in the lower left-hand corner of the 
dialog box. 


The user-defined tool will be deleted. 
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Pages 


Algorithm Tools 


You can organize the Algorithm Tools palette into different pages, so 

that you can choose from a more specialized set of blocks. For instance, 
you could make a page with only analog synth-related blocks, one with 
physical modeling blocks, one with input and output blocks, and so on. 


The page numbers of the existing pages are shown in the top left of the 
palette; when first starting up the program, there will be only a single 
page. Clicking on these numbers selects the corresponding page. To 
add another page, #-click on any of the page numbers; a dialog box 
will appear, prompting you to name the new page. To delete a page, 
option-click on its number (a dialog box will ask you to confirm the 
delete). 


The page name is shown in the status bar at the top of the palette. You 
can edit this name at any time; double-clicking on the page number 
brings up the rename dialog box. 


As in the Control Panel window, you can change the order of the pages 
by clicking in the number, waiting for an outline to appear, and then 
dragging the page to a new location. 
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Each block has its own special parameters, but they are arranged ina 
consistent and orderly fashion. 


You can open this window in several different ways, including ae - 
clicking on a block, selecting a block and then pressing Return, or 
selecting Edit Block from the Block menu. 


An arrow pointing to a port name shows that a wire is connected to the 
port, which means that the default value entered within the block will 
be ignored. 


Names for ports, menus, constants Values Value Controls Lock Visible Use 


2 Untitled: Block: enve ae 
[Blogk Type Caleulation Show [mustbe compiled gy Vp 


rarrie : envelope 
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(— trigger: 
output: 
level: 
rate: 
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— ere opie: Rarmip 


storage: Current 


‘— update : 
p— attack: 


Constants : 
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Shortcuts 
Click on Port Name Opens the port parameters dialog box, allowing you to set min and 

max values, port position, etc. This is the same as clicking on the port 
name in the Block window. For a detailed explanation of the port 
parameters dialog box, please see page 106. 

Click on MultiTable Name Opens the MultiTable window for the currently selected MultiTable. 
For more information on the MultiTable window, please see page 75. 

a -Click on MultiTable Name Brings up a menu of the Tables in the MultiTable. Selecting a Table from 
the menu will open up its Table window, allowing you to edit it 
directly. For a detailed look at the Table window, please see page 88. 
ae G Brings up the Grow dialog box for the current block, allowing you to 


add more ports. 


a6 U Brings up the UnGrow dialog box for the current block. 
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a8 -Click on Any Name 


Option-Click on Any Name 


Option-Click on Visible Icon 


Block Menu 
Locked 


Make 


Grunge 


Type Menu 


Dsp 


Host Demand 


ost | 


ost 2 


ost 3 


Block 


Grows the selected port, constant, or menu, if grow is available for that 
item. The new item will be placed immediately after the item that is 
clicked on - as opposed to using command-G, which always adds the 
new item to the end of the list. 


Un-Grows the selected port, constant, or menu, if it has been grown. 


Toggles all ports between visible and invisible. 


This is currently unimplemented. 


The “make” flag tells SynthKit whether or not the block needs to be 
compiled. This menu command shows you the current status of the 
make flag, with a check-mark to indicate that it is on. If you like, you 
can change this - but it isn’t advisable, and you shouldn’t need to do so. 


Pops up a plaid shirt and a map of Seattle, and assists in the growth of a 
small amount of facial hair located directly on the chin. 


No, just kidding. Grunge randomizes the initial phase of the three oscil- 
lator blocks (Table osc, normal and audio quality). It also randomizes 
the first sample from the output ports of the math block; all subsequent 
samples are unaffected. 


The Type menu sets whether the block is executed on the dsp or on the 
host, with 5 different update rates available for the host. Many blocks 
may only be run on either the dsp or the host; some can be run on both. 
For information on a specific block, please see the chapter Host & DSP 
Specifics, on page 222. 


The rates used for Host 1, 2, 3, and 4 are set in the Execution window. 


There is a detailed explanation of the Type selections under the heading 
Block Processing, on page 100. 


The block will be executed on the Dsp, for maximum resolution and 
speed. 


The block will be executed on the Host as needed. For instance, a math 
block processing controller data only needs to work when the controller 
is actually moved; most of the time it can lie dormant. For blocks with a 
constant output - envelopes, for instance - the Calculations menu 
within the block determines the update rate when the block is being 
used. 


The block will be executed on the Host (the Macintosh), using the Pri- 
ority 1 update rate, as set in the Execution window. 


The block will be executed on the Host, using the Priority 2 update rate, 
as set in the Execution window. 


The block will be executed on the Host, using the Priority 3 update rate, 
as set in the Execution window. 
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The block will be executed on the Host, using the Priority 4 update rate, 
as set in the Execution window. 


When this option is selected, only new values will be sent out from the 
block. This can be used to reduce the amount of redundant processing 
in an algorithm (for blocks which change infrequently, and would thus 
otherwise be sending out the same value for many sample periods), or 
to slow down the output of certain dsp blocks so that they can be fed 
into a host block. 


For a detailed explanation, please see Block Processing, on page 100. 


Propagate On Change works in addition to the choice of dsp, host 
demand, or host 1/2/3/4. 


These settings determine the update rate used by the host when assist- 
ing dsp-executed blocks (such as the host calculating coefficients for a 
filter), or the rate at which updates are processed for a Host Demand 
block. Thus, you will be able to set up a filter cutoff parameter as host 
demand, but if its input is changed, it will temporarily be updated at 
the Calculation rate (host2, for example) until the host calculation is fin- 
ished. In this way, processor-intensive host tasks can be broken up over 
a period of time. 


For more information, please see Block Processing, on page 100. 


As noted above, the rates used for Host 1, 2, 3, and 4 are set in the Exe- 
cution window. 


This is generally not used. 

This, also, is generally not used. 

The parameter will be updated at the Priority 1 rate. 
The parameter will be updated at the Priority 2 rate. 
The parameter will be updated at the Priority 3 rate. 
The parameter will be updated at the Priority 4 rate. 


Each parameter has a number of values associated with it, such as its 
value and the format of that value, whether it is locked, visible, used on 
compile, etc. Especially on smaller screens, however, this may be too 
much information to show at one time. The Show Menu allows you to 
choose which parameters you want to see; these are stored separately 
for each individual block. If a parameter is checked off in the menu, it 
will be shown; to toggle a check-mark on or off, select the item from the 
menu. 


You may also choose whether or not to see a parameter at all, depend- 
ing on the settings of the Visible and Used parameters. 
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Invisible 
Unused 


Value 


Convert Format 


Contro 


Block 


Shows parameters even if the “visible” box is not checked. 

Shows parameters even if the “used” box is not checked. 

Shows the value. 

Shows the format of the value. 

Shows a slider for all ports. 

Shows the lock/ unlock check box. This is currently not implemented. 
Shows the visible / invisible check box. 


Shows the used/ unused check box. 
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Cc omme nt annotate an algorithm 


The Comment window allows you to put notes directly into a SynthKit 
file. You can create performance notes, or explain programming tech- 
niques. 


Text Field 


You can enter text here. As a default, it will be initialized with the 
owner name from your Macintosh’s Sharing Setup control panel. 
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Constant... 


The Constant Samples, Tables, MultiSamples, and MultiTables are 
stored internally by SynthKit, and are always available. They are per- 
manently locked, and cannot be edited by the user. 
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Constant... 


these tables and samples 
are always available 


The Constant windows act just like their user-programmable counter- 
parts, the Samples List (page 86), Tables List (page 95), MultiSamples 
List (page 73), and MultiTables List (page 77). 
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Constant 
MultiTables 


Constant 
MultiSamples 


cSine 


Constant 
Samples 


cSine 


Constant 
Tables 


cLinear 


cSqrt 
cSine 
cCosine 
cTangent 


clanh 


CAllpass 
cEqualizationCos 


cEqualization Tan 


Constant... 


Most of the commonly used Tables are included in the Constant Tables 
and MultiTables. Since Table memory is at a premium, it’s best to share 
Tables wherever possible (it’s much better than eating alone, certainly). 
Using the Tables and MultiTables from these lists will help to ensure 
that this sharing occurs. 


All constant MultiTables reference a single Constant Table of the same 
name; see Constant Tables, below, for their descriptions. 


This references a single-cycle Sample of a sine wave (cSine, below), pro- 
vided for diagnostics. 


This is a single-cycle sine wave, provided for diagnostics. 


The Constant Tables are divided into four pages. 


Basic Constant Tables 


You can use this for creating a sawtooth wave, or for diagnostics - or if 
you are running audio through a Table block, and wish to have a selec- 
tion for linear throughput. 


This Table allows you to calculate square roots in real time - something 
the math block can’t do. 


You can use this Table as an oscillator or hammer, or for any other 
required sine waves. 


You might use this to provide phasing against the sine wave (although 
you could also manipulate the phase of the sine Table). 


This is a tangent function, from -1/4 to 1/4. 


This Table creates those beautiful s-shaped curves. (“Gosh, Marge, how 
do you get those beautiful curves, anyway?” “Well, to tell you a 
secret...have you tried cTanh?”) 


This is used internally for allpass filtering. 
This is used internally for EQ. 


As above, this is used internally for EQ. 
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cShelf 
cFirSine 
clirSine 
clirCosine 


clirTangent 


cRaisedCosine 


cReed 


cBow 


cExp44Note 
cExp44Length | 000 


cExp44Length2000 


cExp48Note 


cExp48Length | 000 


these tables and samples 
are always available 


Used internally for shelving. 

Used for the Fir filter block. 

Used for the lir filter block. 

As above, used for the lir filter block. 

Also used for the lir filter block. 

This is the basic hammer Table. 

There is a ‘cRaisedCosineNoise’ multitable and table imme- 
diately following the ‘cRaisedCosine’ 


random noise multiplied by raised cosine (creating a burst 
of noise) 


This is the basic reed Table. 

The basic bow Table. 

immediately following the cBow, there are.... 
‘cExp’ exponential table 


‘cExpSV2’ - used for state variable filters (to make it play at 
a frequency that tracks the keyboard) 


‘cExpLPF’ - similar, but for lowpass 


multitables and tables. 


44.1kHz Note and Length Tables 


These three tables are used for delay and note processing when using a 
44.1kHz sampling rate. See also the 48kHz tables, below. 


This is used to process pitch input for oscillators, filters, etc. 


This Table is for processing pitch input to default delay lines of 22.67574 
msec (single 1000 sample delay at 44.1khz). 


Use this Table for processing pitch input for Cylinders (and Cylinder- 
based blocks, such as Tube Admittance and Tube Reflection) of 22.67574 
msec (two 1000 sample delays at 44.1khz). 


48kHz Note and Length Tables 


These three tables are used for delay and note processing when using a 
48kHz sampling rate. See also the 44.1kHz tables, above. 


This is used to process pitch input for oscillators, filters, etc. at a 48kHz 
sampling rate. 


This Table is for processing pitch input to default delay lines of 20.83333 
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msec (single 1000 sample delay at 48khz). 


cExp48Length2000 Use this Table for processing pitch input for Cylinders (and Cylinder- 
based blocks, such as Tube Admittance and Tube Reflection) of 20.83333 
msec (two 1000 sample delays at 48khz). 


There is also a ‘cExp48NoteSV’ (for state variable) table 
immediately after ‘cExp48Length2000’. . 
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Sliders, 
Selectors, 
and Meters 


use graphic objects 
to edit SynthKit algorithms 


SynthKit’s Control Panel is based on the Sliders, Selectors, Meters, and 
System Sends and Receives placed in the algorithm. When an algorithm 
is first designed, all of these Control Panel objects are automatically 
placed on the Control Panel; you can then use them to edit the algo- 
rithm in real time. 


You can add more pages to the Control Panel, each of which can contain 
different settings of the sliders, selectors, etc., for different voicings of 
the same algorithm. 


The Space option, in the Commands menu, will automatically group 
sliders, selectors, etc. based on their positions within nested algorithms. 
Groups are placed within rectangles, titled with the names of each sub- 
algorithm. This visual organization can make your algorithms much 
easier to understand. 


For more visual embellishment, you can add text (for comments and 
additional explanations), lines, rectangles, icons, and pictures to the 
Control Panel, using the Control Panel Tools window. Icons and pic- 
tures can be pasted in from other applications. 


Select a control panel object by clicking on its name or value (for 
graphic objects such as line, text, box, pictures, and icons, you can click 
anywhere in the object); when selected, objects will have a small black 
square in each corner. 


You can delete all Control Panel objects except for Sliders, Selectors, 
and Meters. 


Using the Import command in the File menu, you can import pages of 
Control Panel settings from other SynthKit files, as long as the slider 
names and block IDs are identical to those of the current file. 


These “Big Three” are the Control Panel objects you'll probably use the 
most. Sliders are used for modifying continuous ports in an algorithm, 

such as filter cutoff or envelope times; selectors, for modifying enumer- 
ated ports, such as the outputs of a router block; and meters, for moni- 

toring signals within the algorithm. 


Sliders 


These most commonly used Control Panel objects allow you to edit 
continuous values in real time. 


Selectors 


Selectors are used to choose between a list of options, such as a source 
for a router block output, selecting a MultiTable for a Table-based block, 
etc. When you connect a new selector block to a port, the selector auto- 
matically adds as many states as required - for instance, if a router has 5 
inputs, the selector adds 4 states, for a total of 5. This only works the 
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first time that a selector is hooked up; if the options for the connected 
port increase, then you must add more selector states manually. 


Each state of a selector can be named, in both the Control Panel and in 
the selector block itself; however, entering names in one will not auto- 
matically update the other. The most efficient method is to enter names 
for selector states in the Control Panel, using Edit Special in the Com- 
mands menu, and then use the Specify command to send the names 
down to the block itself. To do this: 


1. Adda selector block to the algorithm, and connect its output to 
the port it will control. The selector will automatically add as 
many states as the connected port requires. 


2. Locate the corresponding object in the Control Panel. 


After locating the desired Selector in the Control Panel, select it 
by clicking on its name or value. 


4. Choose Edit Special from the Control Panel Commands menu. 
This will bring up a dialog box in which you can enter names for 
each state. 


5. To change the name of a state, just select it from the list and enter 
the new name in the field below. You can also add states from this 
dialog box. When you're finished, click OK. 


6. After naming the states, the Selector object will remain selected. 
Choose Specify from the Commands menu; this will send the 
names (along with the current state as a default) to the algorithm- 
level selector block. 


Meters 


Meters allow you to monitor the signals within an algorithm. For the 
Tube, Lattice, and Ladder blocks, you can use the “size” display type to 
show the relative admittances of the block’s segments. 


Normal Editor for Sliders, Selectors, & Meters 


You can edit these parameters by either selecting an object and then 
choosing Edit Normal from the Commands menu, or by double-click- 
ing on the object’s name or value. 


Name This parameter is read only, and shows the name of the slider / selector / 
meter You can change this name by editing the actual slider / selector / 
meter block itself, in the Algorithm window. 


Name Type If a slider/ selector /meter has been grown, the multiple objects use a 
suffix after the block name. The suffix can be either a number (slider 1, 
slider 2, etc.), a letter (slider A, slider B, etc.), or - for control of stereo 
blocks - “L” and “R,” for left and right. 


Number. Uses a number as the suffix - slider 1, slider 2, etc. 
Alphabetical. Uses a letter as the suffix - slider A, slider B, etc. 
Left Right. Uses L for the first object, and R for the second. 
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This is used for creating exponential slider response. Zero is linear, pos- 
itive is exponential (anti-logarithmic), and negative is logarithmic. A 
value of 10.0 seems to work well. You can enter a taper value directly, or 
use one of the several preset values. 


Taper affects the way that the display (target) value relates to the inter- 
nal (original) value. For instance, one could make an Ifo rate slider 
which offered fine resolution at low speeds, and then more coarse reso- 
lution at fast speeds - or vice-versa. 


(For the curious, the actual formula is (T/V - 1)/(T-1), where T is the 
taper and V is the input. It is adjusted if V <0 to -(T’-V)/(T-1) and the 
identity of T is 0. The idea is that 0 always maps to 0, and 1 always 
maps to 1, but the rate of change between the two is controlled by the 
taper.) 


Linear. This enters a value of 0. 
AntiLog1. This enters a value of 10. 
AntiLog2. This enters a value of 20. 
Log]. This enters a value of -10. 
Log2. This enters a value of -20. 


Custom. If you enter your own value, the menu will switch to this 
selection. 


This is the numerical format in which a slider or meter actually sends 
its data (this parameter is not used for selectors). The choices are the 
same as for Target, below, but only continuous formats are selectable - 
enumerated formats such as Pitch Number are grayed out. All choices 
are available for the Target format, however. 


This is the numerical format which the object uses for display. 


Decimal. The value is expressed as a 24-bit integer, centered around 0. 
8,388,608 decimal = 1.0 float. You can use this format for both enumer- 
ated and continuous ports (as opposed to Float, which is for continuous 
ports only). 


Hexadecimal. Values are in Hex (base 16); Hex $7FFFFF = +1.0 Float. 
This can be better than float for viewing small numbers very precisely, 
since it is closer to the actual number system of the computer. It may 
take some getting used to, though... 


Float. Floating-point numbers; this is the standard format. On the dsp, 
these are -1.0 to +1.0; on the host, these can be greater. 


Exponential. Uses exponential notation. For example, a small number 
might be displayed as “1.23e-5;” this means 1.23 * 10°, or 
1.23 * 0.00001, which is equal to 0.0000123. 


Parameter +. This is most useful for the Display Format, as opposed to 
the Internal Format. It allows you to display a parameter in familiar 
synth-style formats, such as 0-10, 0-100, etc. The port’s value is com- 
puted using the equation, (value-min) /(max-min)*parameter limit, 
using the minimum and maximum values from this window, and the 
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parameter limit from the General page of the Preferences dialog. For 0- 
100 ranges, set the parameter limit to 100. 


Parameter +-. Similar to Parameter, but displays from -100 to +100 
(again, using the parameter limit from the General page of the Prefer- 
ences dialog). 


dB. This translates the amplitude values into dB. 


Pitch Linear. This is the native format of Receive Note. Most of the 
time, blocks expect this value to be converted through an exponential 
Table. 


Pitch Exponential. Used for the pitch of oscillator blocks, hammers, etc. 
Pitch Hertz. Shows the frequency of the current field. 


Pitch Number. This is based on the MIDI note number of the pitch 
(with additional fractions for intermediate values). 


Pitch Name. Shows pitch name plus cents for intermediate values. 


Length Linear. Don’t use this - it’s not the format you’re looking for 
(yes, Obi-Wan Kenobe). 


Length Exponential. Can be used for the pitch of delay blocks, includ- 
ing cylinders, tubes, echoes, etc. Most people use Samples or Millisec- 
onds instead. 


Samples. This can be used for delay line lengths; it shows the number 
of samples in the delay (time*sample rate). 


Milliseconds. This is the default format for delay-based blocks. 


Centimeters. This uses the Preferences parameter, “Speed of Sound,” to 
convert from time to distance. Use it for really slick looking reverb algo- 
rithms - impress your family and friends! 


We now have ‘Wet/Dry’ and ‘Beats Per Minute’ as the last 
two format choices after ‘Centimeters’. 


Number of Digits This sets how many digits or letters are used to display the value of the 
slider / selector. If you enter 0 here, then no value is shown. 
Value The current value of the slider. 
Minimum This is the minimum value of the slider/ selector / meter; in combination 


with Maximum below, you can use this to restrict the movement to a 
useful range. 


Maximum This is the maximum value of the slider /selector/ meter; in combina- 
tion with Minimum above, you can use this to restrict the movement to 
a useful range. 


Scaling Factor This allows you to scale the displayed value without affecting the inter- 
nal value. The internal value is multiplied by the scaling factor to pro- 
duce the displayed value. 


Complement Oh! Thank You! (Ummm - sorry - never mind.) Checking this box will 
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make the object display values using the formula “X: max + min - X.” 
For instance, a value of 44, with a minimum of 0 and a maximum of 
100, would be calculated as “44: (100+0-44)”, and displayed as simply 
“44:56.” Used with the Parameter display format, you can get displays 
appropriate for effect balances, pans, and so on. 


If the appropriate items in the Control Panel section of the Preferences 
dialog are checked, new System Sends and Receives are brought up to 
the Control Panel as they are added to the algorithm. You can also man- 
ually add existing Sends and Receives by using the Add To Control 
Panel command on the Algorithm window’s Block menu. 


Having System Sends and Receives on the Control Panel allows you to 
control MIDI modulation routing without going down to the block 
level. They act very similar to Selectors, and you can choose to display 
them as sliders, knobs or menus. They have no “normal” editor. 


When you use the Group command, SynthKit places a rectangle around 
the selected Control Panel items. You can use this to group related sets 
of items together; the controls for an ADSR envelope, for instance, or 
the Cutoff, Resonance, and Key Scaling parameters for a filter. 


You can edit the appearance of those Rectangles, if you like; you can 
also create your own groupings by adding Rectangles manually. 


When you use the Space command, SynthKit groups your Control 
Panel objects based on their parent Algorithm blocks - and uses the 
Rectangle object to group them visually. You can edit the appearance of 
those Rectangles, if you like; you can also create your own groupings 
by adding Rectangles manually. 


You can use Lines to add visual organization to the Control Panel. For 
instance, you might wish to insert sub-divisions into a Rectangle group- 
ing. 

To add a Line object to the control panel, select the line object from the 


Control Panel Tools window, and then click and drag in the Control 
Panel. The distance that you drag determines the height and width of 
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the Line. This click-and-drag procedure is the same for all objects in the 
Control Panel Tools. 
Normal Editor for Lines 


You can edit these parameters by either selecting a Line and then choos- 
ing Edit Normal from the Commands menu, or by double-clicking on 
the Line’s name or value. 


Size. This sets the width of the line, in pixels. 


Pattern. This chooses the pattern for the line - the different grays only 
make much of a difference if the Size is greater than 1. 


Text 
If you like, you can add Text objects to the control panel, for extra expla- 
nations, built-in help, acknowledgments, and so on. 
To add a Text object to the control panel, select the desired object from 
the Control Panel Tools window, and then click and drag in the Control 
Panel. The distance that you drag determines the height and width of 
the Text. 
Normal Editor for Text 
You can edit these parameters by either selecting a Text object and then 
choosing Edit Normal from the Commands menu, or by double-click- 
ing on the object’s name or value. 
Text. This is the text that will be displayed in the text object. 
Font. This is the font of the text; the choices are determined by the fonts 
installed in your system. 
Face. The text can be bold, italic, shadowed, etc. 
Size. You can enter in any desired text size. 
Justify. The text object may be aligned to the left, to the right, or to the 
center. 
Pictures 
and Icons 


You can use the Picture or Icon objects to add visual information to the 
Control Panel - conceptual diagrams, portraits of your mother, etc. 


For more information on adding Picture or Icon object to the control 
panel, please see “Adding Icons & Pictures” on page 63. 
Normal Editor for Pictures and Icons 


You can edit these parameters by either selecting a Picture or Icons 
object and then choosing Edit Normal from the Commands menu, or by 
double-clicking on the object’s name or value. 


Get Icon or Picture. This feature is intended to let you grab an icon or 
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MultiTables 
& MultiSamples 


Control Panel 
Pages 


Shortcuts 


Double-Click 
Option-Double-Click 


picture out of another file; for now, it isn’t implemented (use copy and 
paste instead). 


Clip. This parameter appears for pictures only. If it is unchecked, the 
picture will be scaled to fit within the dimensions of the Picture object; 
if it is checked, the picture remains at its normal scale, and the edges are 
clipped to fit within the Picture object. 


For use in the editing of future instruments, all blocks with references to 
MultiTables or MultiSamples can add corresponding table / sample 
placeholders to the Control Panel. Currently, selecting a new Table or 
Sample requires a recompile, and so you can’t use these Control Panel 
items for editing. In the future, however, you should be able to - for 
instance - select between oscillator waveforms, Samples, etc. 


If “Insert MultiSample Blocks” and “Insert MultiTable Blocks” are 
checked in the Control Panel Preferences, these Control Panel items will 
be added automatically. If not, you can add them manually by using the 
Add To Control Panel command on the Algorithm window’s Block 
menu. 


You can add more pages to the Control Panel, each of which can contain 
different settings of the sliders, selectors, etc., for different voicings of 
the same algorithm. 


To add a new page, use the Edit menu’s Grow command (#8G). The 
new page will initially be a copy of the current page, and can then be 
edited as desired. 


To select a page on the Control Panel, simply click on the desired page 
number; you can also use the Page Up/ Page Down/Home/ End keys 

on the Apple Extended Keyboard. Alternately, you can select them by 

name from the Page menu. 


To change the ordering of the pages, hold the mouse button down on 
the page number until an outline appears; you can then drag the page 
to another location in the list. To rename a page, use the Rename com- 
mand on the Edit menu (3#=). 


Objects 
Brings up the “normal” editor. 


Brings up the “item” editor. 
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36 -Double-Click 
Control- #6 -Click 
Option-Drag 
Arrow Keys 
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Page Up 
Page Down 
Home 


End 


Commands 
Menu 


Locked 


Program Change 
Snap To Grid 


Edit Items... 


Control Panel 


Brings up the “special” editor. 

Selects all Control Panel objects in the object’s group. 
Resizes the object. 

Move the selected object one pixel at a time. 


Move the selected object, locking to the grid size set in the Commands 
menu Align dialog. 


Pages 

Grow another page. 

Un-Grows (deletes) the current page. 

Rename the current page. 

Selects the next page of the Control Panel. 
Selects the previous page of the Control Panel. 
Selects the first page of the Control Panel. 
Selects the last page of the Control Panel. 


When this option is checked, control panel objects cannot be selected or 
moved. You can turn this on after setting up your control panel, so that 
you can use the sliders/selectors/etc. without risk of inadvertently 
moving them around. 


This option is currently unimplemented. 


When this option is checked, control panel objects can only be dragged 
to locations on an evenly-spaced grid. As you move the slider/selec- 
tor/etc., it will jump from one grid position to another. Snap To Grid 
uses the Align grid, as set up in the Align dialog box, below. 


All control panel objects support the same “item” editor, which has 
type, placement and border information. 


Double-Clicking on a control panel object will also bring up this dialog 
box. 


Lock. Locking prevents the size and location from being changed, as 
well as access to the other dialogs. 


Type. You can control the appearance of each Slider, Selector, Meter, 
System Send, and System Receive on the Control Panel. Several differ- 
ent display options are available, depending on the type of the object. 


Slider types include: 


Slider. This is the normal slider object; you can grab the handle 
and move the slider to change the value, or click above or below 
the handle and the slider will move smoothly to the mouse posi- 
tion. 
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The other types available besides Slider are now: 
Knob Standard 

Knob Mod Amt. 

Knob Wet/Dry 

Knob Level 

Knob Pan 


all of these are simply for appearance. 


Knob Dot. This is a rotary knob, with a dot indicating the current 
knob position. Change the value of the knob by dragging the 
mouse in a circular motion, similar to a real knob. 


Knob Line. This works the same as the Knob Dot above, but the 
current position is shown by a line, instead of a dot. 


Text. A text box appears instead of a graphic object; values can be 
entered in directly. 


Again, Knob Dot and Knob Line are now obsolete. 


System Receive types include the Slider’s Slider, Knob Dot, and Knob 
Line, as well as one more option: 


Menu. The labels for each System Send choice (MIDI and system 
modulators) appear in a menu. When using menus, you may 
wish to expand the item from its default width; otherwise, the 
longer menu labels may be clipped. 


Again, the knob types are now the five mentioned above. 


Selector types include, in addition to the Slider’s Slider, Knob Dot, and 
Knob Line, and the System Send /Receive’s Menu: 


Radio Buttons. Each state of the selector appears as a radio but- 
ton. 


Button. This is applicable to two-state selectors only. When the 
button is pressed down with the mouse, it is set to 1; at all other 
times, it is set to 0. This can be used as a manual trigger, for enve- 
lopes, hammers, and so on. 


Checkbox. Like Button above, this is only applicable to two-state 
selectors. When the box is filled in, the selector is set to 1; when 
empty, it is set to 0. You can use this to turn a function on and off 
- such as portamento, for instance. 


Meter types include: 
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Meter. This is a simple, linear meter. 
Gauge. The Gauge is a needle-type meter. 


Size. This is similar to the normal meter, but shows an increase in 
both positive and negative directions as input increases. This 
option is meant for use with lattice and tube blocks, to graphi- 
cally display the sizes of the individual segments. 


Orientation. Control panel objects can be either vertical or horizontal; 
for instance, a slider can be oriented up-down, or left-right. You can 
also use the orientation to control the arrangement of a set of radio but- 
tons. 


Vertical. The object will be displayed vertically. 
Horizontal. The object will be displayed horizontally. 


Width. This sets the width of the slider /selector/etc., in pixels. You can 
also adjust the size of an object using the mouse (option-click near a 
corner of the object, and then drag). 


Height. This sets the height of the slider/selector/etc., in pixels. You 
can also adjust the size of an object using the mouse (option-click near a 
corner of the object, and then drag). 


All the following through ‘Shadow Size’ are obsolete. The 
replacements are: 


Left - this is the coordinate of the left edge of the item. 
Top - this is the y coordinate of the top edge of the item. 
Label Width - The width of the item label. 

Slider Length - For a slider, it’s length. 


Text Width - the size of the value display. This is imple- 
mented a four radio buttons that select the sizes choosen for 
small, medium and large in the preferences dialog. The 
forth selection allows the user to type ina value. 


Horizontal. This sets the horizontal position of the object; the value is 
in pixels from the left side of the window. You can also move the object 
with the mouse; click and drag on the object name. 


Vertical. This sets the vertical position of the object; the value is in pix- 
els from the top of the window. As above, you can also use the mouse to 
move the object. 


Group. This read-only parameter shows which Control Panel group the 
object belongs to. Sliders/ selectors /etc. are grouped by their sub-algo- 
rithms; these groups can be displayed using borders in the Control 
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Panel. 


Access. This option allows you to specify how a parameter will be 
viewed on future instruments. 


None. This means that the parameter will not appear on the 
instrument. 


Normal. This tags the parameter to appear on the medium-level 
editing of the instrument. 


Palette. This brings the parameter up to the high-level editing of 
the instrument (as well as lower levels). If this option is selected, 
an asterisk is appended to the object’s name in the Control Panel 


The “normal” editor is specific to each type of Control Panel object. See 
the notes for each of the objects for the contents of their editor. 


Option-Double-Clicking on a control panel object will also bring up this 
dialog box. 


The only object that currently has a ‘special’ editor is the selector; this is 
where its labels are edited. $8-Double-Clicking on a Control Panel 
object will also bring up the Edit Special dialog. 


This brings up a dialog box to simultaneously alter the size, shape, and 
spacing of multiple Control Panel objects. There are two main options; 
Set, which changes all selected objects to the same size, and Scale, 
which changes objects to a percentage of their current size. 


Set. When this option is chosen, all selected objects will be changed to 
the size set by the Width and Height parameters. 


Scale. When this option is chosen, all selected objects will be changed to 
the specified percentage of their current size. This allows you to main- 
tain relative size differences. 


Location. This is only used for the Scale option. When the box is 
checked, the relative spacing of the objects will change along with their 
size. 


Object Types. These check-boxes allow you to select which object types 
(Sliders, Meters, etc.) will be affected by the Size or Scale commands. 
Only the selected types of objects will be modified. 


Set Number Of Digits.... This brings up a dialog in which you can set 
the value for number of digits in the value display for the selected con- 
trol panel items. 


Align will automatically adjust the positions of the selected control 
panel objects horizontally and/or vertically. This selection brings up a 
dialog box with a number of settings, as described below. 


The align dialog is like previous ones mentioned. Its fields 
are: 


Radio group with choices None, Left, Center, Right 
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A checkbox to use the grid. A text entry of the grid size in 
pixels. 


A radio group with choices None, Top, Center, Bottom 


A checkbox to use the grid. A text entry of the grid size in 
pixels. 


Horizontal Grid. Arranges the selected control panel objects along a 
horizontal grid of the specified number of pixels. The part of the block 
matched to the grid (right side, left side, or center) is set by the horizon- 
tal align by: buttons, to the right of the window. 


Horizontal Average. Averages the horizontal positions of the selected 
control panel objects. The part of the block used for the average (right 
side, left side, or center) is set by the horizontal align by: buttons, to the 
right of the window. 


Horizontal Unchanged. The Align command will not affect horizontal 
position when this option is selected. 


right. Control panel objects will be horizontally aligned by their right 
sides. 


left. Control Panel objects will be horizontally aligned by their left 
sides. 


center. Control Panel objects will be horizontally aligned by their center 
points. 


Vertical Grid. Arranges the selected control panel objects along a verti- 
cal grid of the specified number of pixels. The part of the block matched 
to the grid (top, bottom, or center) is set by the vertical align by: but- 
tons, to the right of the window. 


Vertical Average. Averages the vertical positions of the selected control 
panel objects. The part of the block used for the average (top, bottom, or 
center) is set by the vertical align by: buttons, to the right of the win- 
dow. 


Vertical Unchanged. The Align command will not affect vertical posi- 
tion when this option is selected. 


top. Control Panel objects will be vertically aligned by their top sides. 


bottom. Control Panel objects will be vertically aligned by their bottom 
sides. 


center. Control Panel Objects will be vertically aligned by their center 
points. 


Space... The Space command allows you to visually organize the Control Panel, 
by automatically grouping the selected sliders /selectors/ meters etc., 
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Group... 


Specify 


Bring To Front 


Send To Back 


Page Menu 


based on their position within nested algorithms. 


Spacing uses the Control Panel spacing parameters from the Prefer- 
ences settings (under the File menu). 


Simple. This option spaces out the control panel objects from right to 
left, using the order of the control panel blocks within the algorithm. 


Group. This places rectangles around Control Panel objects from the 
same algorithm or sub-algorithm. 


Max Consecutive. This option limits the width of each group to 
the specified number of sliders /meters/etc.; the groups will 
expand vertically as necessary. 


No Empty Rects. When this box is checked, rectangles won’t be 
created for algorithms which don’t contain control panel items. 


Align Nested. This vertically aligns all the sliders within a group, 
vertically adjusting all sub-groups as necessary. 


Adjacent Rects. Similar to Align Nested, this vertically aligns 
sliders within different groups. 


This groups the selected control panel items together, and puts a rectan- 
gle around them. A dialog box will appear, prompting you to name the 
new group. Visually, this is the same as using the Group option under 
Space, as described above. 


This command copies the current value, min/max, and display format- 
ting for the objects of the current Control Panel page back into the algo- 
rithm. Selector labels are copied back to the selector blocks in the 
algorithm, as well. 


Performing the Specify command ensures that when the algorithm is 
imported, the correct values will be brought into the control panel. 


If several Control Panel objects are clustered in the same space, obscur- 
ing one another, this command will bring the selected object to the front 
of the pile, so that it can be seen and edited. You might just want to use 
the Space command, though... 


Similar to Bring To Front above, this will move the selected object to the 
back of the pile. 


This menu shows all the pages in the current Control Panel by name. 
You can select pages from this menu, or by clicking on the page num- 
ber; you can also use the Page Up/ Page Down/Home/End keys on the 
Apple Extended Keyboard. 
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Selection Arrow 


Text 


Line 


Rectangle 


Icon 


Picture 


Adding Icons & 


Pictures 


Control Panel Tools 


The Control Panel can automatically display and group sliders, selec- 
tors, meters, and so on, but you may also add your own cosmetic 
enhancements - including text, lines, rectangles, pictures, and icons - 
with the Control Panel Tools. 


Selection Arrow Text Line Rectangle Icon Picture 


Control! Panel Tools window 


This is the basic Control Panel tool; use it for selecting, dragging, resiz- 
ing, and otherwise editing Control Panel items. 


The Text tool allows you add text to the Control Panel, for performance 
notes, instructional haikus, and so on. Place text by clicking and drag- 
ging in the Control Panel with the Text tool; the distance that you drag 
determines the text’s height and width. 


To add a line to the control panel, select the Line tool and then click and 
drag in the Control Panel. The distance that you drag determines the 
line’s height and width. 


Rectangles are automatically added around groups of sliders /selec- 
tors/etc. in the Control Panel; you can also add your own, using this 
tool. To place a rectangle, click and drag in the Control Panel; the dis- 
tance that you drag determines its height and width. 


This tool allows you to add icons to the Control Panel; for more infor- 
mation, see Adding Pictures & Icons, below. 


This tool allows you to add pictures to the Control Panel; for more 
information, see Adding Pictures & Icons, below. 


To add a Picture or Icon object to the control panel: 


1. Create the picture or icon you'd like to use, and copy it to the clip- 
board. For icons, SynthKit expects the type “ICON,” which can be 
created within Res Edit; for pictures, SynthKit uses the standard 
“PICT” type, as created by Mac Paint and other bitmap paint pro- 
grams. 


Windows 
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add graphics to the 
Control Panel Tools Control Panel 


2. Select the desired object from the Control Panel Tools window. 


3. With the object selected (the cursor will turn from an arrow into 
the word ITEM), click and drag in the Control Panel. The distance 
that you drag determines the height and width of the Picture or 
Icon; you can resize it later if necessary. 


4. Select the new Picture or Icon object, and paste in the graphic 
created in step 1. 
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the root window 
of the SynthKit file 


Document 


The Document window is the root window of a SynthKit file. Closing 
this window will also close the file to which it belongs. The window 
itself is used to display text and error messages resulting from the Com- 
mands menu selections, and from the File menu’s Compare function. 


Windows 
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Execution 


Parameters 


sampling rate 


priority | 


priority2 
priority3 
priority4 
delay length 
bore length 


patch attenuation 


dsp allocate 


adjust basic 
sound-production parameters 


The Execution window controls SynthKit’s low-level parameters, 
including the sampling rate, host update rates, default delay and cylin- 
der lengths, assignment of algorithms to dsps, choice of digital or ana- 
log inputs, digital clock source, and compilation options. 


Except for the compilation options, these settings affect only functional- 
ity within SynthKit, and do not affect algorithm behavior on target plat- 
forms, such as OASYS PCI. 


This is the sampling rate of the dsp; 44100 is the default. Changing this 
parameter forces everything to be recompiled. 


This is the priority1 host update rate, in milliseconds; in other words, 
this sets how often a host priority] port will be changed. Smaller num- 
bers are faster. The default values for all four host update rates are set in 
the File menu’s Preferences dialog; a standard value for priority] is 1 
millisecond. 


The priority2 host update rate, in milliseconds; the default is 5. 
The priority3 host update rate, in milliseconds; the default is 20. 
The priority4 host update rate, in milliseconds; the default is 100. 
This sets the default delay length for delay-based blocks. 


This sets the default delay length for bore-based blocks, including the 
Cylinder, Tube Admittance, and Tube Reflection. 


If this is set to true, the compilation process will automatically scale 
down summed patch outputs so that they do not clip. 


This determines how SynthKit assigns voices within multiple-dsp card 
setups. When using SynthKit with OASYS PCI, this must always be set 
to Fixed Patch. 


Available. Uses each dsp in turn, going to the next as the current one is 
filled up. This is the normal mode. 


Fixed Voice. Each new voice will be placed on a new dsp. This is proba- 
bly less efficient, but more predictable. 


Fixed Patch. This is the required setting for OASYS PCI. Each new 
patch block will be placed on a new dsp. This is different from Fixed 
Voice, since a Patch may have multiple voices. Note that OASYS PCI 
itself is more clever about how patches are assigned, allowing many 
different patches to run on the same DSP. 


Fixed Patch RealTime. This option allows simpler multi-voice multiple 
card compilations. The root level should have a single patch block con- 
nected up to speakers (and any other shared functionality). The patch 
block should be numbered last. The compiler will try to place the 
shared blocks and as many voices as possible of the patch on the first 
dsp until it is filled up. Then it moves to the next dsp, where it starts all 
over again with the shared blocks and then more voices of the patch. It 
is important to note that there is a copy of the shared blocks on each 
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adjust basic 


sound-production parameters Exe Cc ut i on 


digital interface format 
digital io 

master sync 

dsp accesses 

host timing 

algorithm type 


dsp. 

Fixed Hardware. This is not yet implemented. 

This parameter is not implemented for use with OASYS PCI. 
This parameter is not implemented for use with OASYS PCI. 
This parameter is not implemented for use with OASYS PCI. 
This parameter is not implemented for OASYS PCI. 

This parameter is not implemented for OASYS PCI. 

This determines the type of file which will be generated for OASYS PCI. 
Voice. Use this for synthesis algorithms. 

Effect. Use this for effects algorithms. 

Mod Processor. This is an internal setting. 


Mixer. This is an internal setting, used for generating mixer code. 


Windows 
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Global... 


specify tables and samples 
that you use frequently 


The Global Tables, MultiTables, Samples, and MultiSamples are 
intended to remain constant for a user’s environment, so that they 
appear in all files, similar to the Constant Tables /Samples/etc. Unlike 
the Constant data, though, Global data is editable, and is stored in your 
Preferences file, instead of in the program itself. 


The intention of the Global Tables /Samples /etc. is to allow voicing 
staff to experiment with additional Constant Tables. If you use Global 
data, you must make sure that anyone else using your algorithms has 
the same Global data installed on their system - otherwise, your algo- 
rithms will not play correctly. 


You can copy Global Tables / Samples /etc. into a document, to make 
sure that algorithms will play correctly on someone else’s system. If 
you do so, make sure to change any references in algorithm blocks as 
well. 
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MultiSample 


MultiSample 
Menu 


Locked 
Send 


Show Menu 


Convert Format 


Map 


Decay 


Sample 
Parameters 


Sample 


Top 


group a set of Samples together 


MultiSample reference one or more Samples; you can use a modulator 
(such as note exponential) to select between those Samples in real time. 
Samples are not used directly by an algorithm; they must be referenced 
through a MultiSample. 


You can add new Samples by using the Grow command (3€G), and 
delete the last Sample in the list by using Ungrow (3€U). If the number 
of Samples in the MultiSample is changed, you must recompile to 
update the algorithm. For other edits (to the Top parameter, for 
instance), you don’t need to recompile - just use the Send command in 
the MultiSample menu. 


When this is checked, no edits can be made to the window. 


This command updates the host or dsp with the latest edits to the Mul- 
tiSample; there is no “autosend,” as there is for Tables and Samples. 


This menu selects which Sample parameters are displayed in the win- 
dow. 


This is not implemented yet. 

This shows the Sample assigned to each slot in the MultiSample. 
This shows the Top parameter for each Sample. 

This shows the Level parameter for each Sample. 

This shows the Base parameter for each Sample. 

This shows the Tune parameter for each Sample. 

This shows the Start parameter for each Sample. 

This shows the End parameter for each Sample. 

This shows the Filter parameter for each Sample. 

This shows the Pan parameter for each Sample. 


This shows the Decay parameter for each Sample. 


Each Sample in a MultiSample has an identical set of parameters. 


This is the Sample to be used; you can mix and match document Sam- 
ples with Constant and Global Samples. 


This parameter uses the input to the “position” port of the Sample 
block which uses the MultiSample. Position can be controlled from any 
modulator, but will probably most often be used with pitch exponen- 
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Level 


Decay 


Loop Editor 


tial, so that the note input determines which Sample is played. 


Instead of specifying top and bottom keys for each Sample, the Top 
parameter specifies only the top key (or maximum modulation amount, 
if you’re using a mod source other than notes). The assumption is that 
each Sample in the MultiSample will have progressively higher Top 
values, so that the bottom of Sample 2, for instance, is any value above 
the Top of Sample 1. Sample 1’s bottom value is 0. 


Top is displayed in Hertz (22050.0 Hertz = 1.0 float), and expects note 
exponential as input (though this format is determined by the Sample 
block’s position port, and not the MultiSample itself). Eventually, the 

Convert Format command will control the format of this parameter. 


This is passed on to the Level output of the Sample block, to modulate a 
mix block. When a Sample is played, its individual Level value will 
appear at the block’s Level port. 


This is the root pitch of the Sample, in Hertz. 

This is the tuning of the Sample, as a ratio of the Base; 1.0 is the default. 
The start point of the Sample, in number of samples. 

The end point of the Sample, in samples. 


This is similar to the Level parameter, in that this parameter is handed 
down to the Filter port of the Sample block, to modulate an external fil- 
ter. The format is pitch hertz. 


As with Filter and Level above, this is passed down to the Sample block 
and intended to modulate an external mix or pan block. 


This is handed down to the Sample block, to modulate an external 
Envelope block. 


To bring up the loop editor for a Sample, command-click on the Sam- 
ple’s slot number (the label at the very left, which says “sample 1,” 
“sample 2,” etc.). Any edits made here are stored with the MultiSample, 
and not with the Sample itself; this allows you to use a single Sample in 
multiple places, with different loop points. Any edits will also override 
the loops specified in the Sample editor. 


The loop editor is designed to support multiple loops, although only a 
single loop is currently implemented for real-time execution. 


To edit a loop, click on its start and end points in the dialog box (see 
diagram below), and then enter the new values and press OK. For more 
sophisticated editing, use a dedicated sample editor such as Alchemy 
(formerly from Passport, and now at least temporarily unsupported) or 
Digidesign’s Sound Designer II. 
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Loop Editor Dialog Box 


0.00,5000.00 


Loop Start 


Loop End 
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organize multisamples 


MultiSamples List 


The MultiSamples List shows the MultiSamples stored in the current 
SynthKit file. In addition to those stored in the file, there are also Con- 
stant and Global MultiSamples. Constant MultiSamples (whose names 
are prefixed with “c”) are stored within SynthKit, and cannot be edited; 
Global MultiSamples are stored in your preferences file, and can be 
edited. For more information, please see “Constant...” on page 45, and 
“Global...” on page 68. 


= rubble: Multi$amples List: drums = 


Commands Sort Page| 


Page Buttons ————_»> ff 


List of MultiSamples 


Commands 
Menu 


Locked 


Page Menu 


jazz set 
orchestral 
techno cheese 
dance 1 


Pages allow you to organize the MultiSamples into groups. To go toa 
new page, just click on its button or select it from the Page menu; this 
will also select the page for renaming, deleting, etc. 


You can add new MultiSamples and new pages by using the Grow 
command (6G). If a MultiSample is currently selected, then SynthKit 
will automatically grow another MultiSample; if not, then a dialog box 
will appear, asking what you want to grow (select “Item” for a new 
MultiSample, and “Page” for a new page). Another dialog box will 
prompt you to name the new page or MultiSample. 


To rename the selected page or MultiSample, use the Rename com- 


mand (#§=); to delete the selected page or MultiSample, use Ungrow 
(360). 


You can change the order of the list by clicking on a MultiSample’s 
name and dragging it to a new position; similarly, just click and drag on 
a page button to change the order of the pages. To move a MultiSample 
to a different page in the list, copy and paste into the new page (and 
then use Ungrow to delete it from the original page). 


When this is checked, no edits can be made to the window (including 
growing, ungrowing, and renaming pages and MultiSamples). 


This shows a list of all the pages in the window, so that you can select 
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List of 
MultiSamples 


MultiSamples List organize multisamples 


them by name. You can also select pages by clicking on the page num- 
ber buttons, at the top left of the window. 


This lists all of the MultiSamples stored in the file. There are also sepa- 
rate lists of Global and Constant MultiSamples, as mentioned above. 
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MultiTable 
Menu 


Locked 


Send 


Show Menu 


Convert Format 
Map 
Top 


Level 


Table 
Parameters 


Table 


Top 


MultiTables are used by all of the SynthKit “table” blocks, such as the 
Oscillator Table, Reed Table, Hammer Table, etc., and of course the 
Table block itself. MultiTables reference one or more Tables; you can use 
a modulator (such as note exponential) to select between those Tables in 
real time. Tables are not used directly by an algorithm; they must be ref- 
erenced through a MultiTable. 


You can add new Tables by using the Grow command (3&G), and 
delete the last Table in the list by using Ungrow (#8 U). If the number of 
Tables in the MultiTable is changed, you must recompile to update the 
algorithm. For other edits (to the Top parameter, for instance), you 
don’t need to recompile - just use the Send command in the MultiTable 
menu. 


When this is checked, no edits can be made to the window (including 
growing, ungrowing, and renaming pages and MultiTables). 


This command updates the host or dsp with the latest edits to the Mul- 
tiTable; MultiTables don’t have the “autosend” capability of Tables and 
Samples. 


You can choose which Table parameters will be displayed in the win- 
dow. 


This is not implemented yet. 
This shows the Table assigned to each slot in the MultiTable. 
This shows the Top parameter for each Table. 


This shows the Level parameter for each Table. 


Each Table in a MultiTable has an identical set of parameters. 


This is the Table to be used; you can mix and match Tables from the 
document with Constant and Global Tables. 


This parameter uses the input to the “position” port of the block which 
uses the MultiTable (such as a Table, Oscillator Table, etc.). Position can 
be controlled from any modulator, but will probably most often be used 
with pitch exponential, so that the note input determines which Table is 
played (for “multi-sampled” Tables). 


Instead of specifying top and bottom keys for each Table, the Top 
parameter specifies only the top key (or maximum modulation amount, 
if you’re using a mod source other than notes). The assumption is that 
each Table in the MultiTable will have progressively higher Top values, 
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so that the bottom of Table 2, for instance, is any value above the Top of 
Table 1. Table 1’s bottom value is 0. 


Top is displayed in Hertz (22050.0 Hertz = 1.0 float), and expects note 
exponential as input (though this format is determined by the algo- 
rithm block’s position port, and not the MultiSample itself). Eventually, 
the Convert Format command will control the format of this parameter. 


Level This is handed down to the Level output of a Table block, to modulate 
an external mix block. When a Table is played, its individual Level 
value will appear at the block’s Level port. 
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The MultiTables List shows the MultiTables stored in the current Syn- 
thKit file. In addition to those stored in the file, there are also Constant 
and Global MultiTables. Constant MultiTables (whose names are pre- 
fixed with “c”) are stored within SynthKit, and cannot be edited; Global 
MultiTables are stored in your preferences file, and can be edited. For 
more information, please see “Constant...” on page 45, and “Global...” 
on page 68. 


= rubble: MultiTables List: homer = 


Commands Sort Page| 


Page Buttons ———_»> fj] 


List of Multi Tables lisa 
maggie 
marge 


Pages allow you to organize the MultiTables into groups. To go to anew 
page, just click on its button or select it from the Page menu; this will 
also select the page for renaming, deleting, etc. 


You can add new MultiTables and new pages by using the Grow com- 
mand (#G). If a MultiTable is currently selected, then SynthKit will 
automatically grow another MultiTable; if not, then a dialog box will 
appear, asking what you want to grow (select “Item” for a new Mullti- 
Table, and “Page” for anew page). Another dialog box will prompt you 
to name the new page or MultiTable. 


To rename the selected page or MultiTable, use the Rename command 
(3€ =); to delete the selected page or MultiTable, use Ungrow (3 U). 


You can change the order of the list by clicking on a MultiTable’s name 
and dragging it to a new position; similarly, just click and drag ona 
page button to change the order of the pages. To move a MultiTable to a 
different page in the list, copy and paste into the new page (and then 
use Ungrow to delete it from the original page). 


Commands 
Menu 


Locked When this is checked, no edits can be made to the window (including 
growing, ungrowing, and renaming pages and MultiTables). 
Page Menu 


This shows a list of all the pages in the window, so that you can select 
them by name. You can also select pages by clicking on the page num- 
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ber buttons, at the top left of the window. 


List of 
MultiTables 


This lists all of the MultiTables stored in the file. There are also separate 
lists of Global and Constant MultiTables, as mentioned above. 
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meters show amount of 
host processing being used 


Meters 


average 


peak 


Process Time 


The Process Time window gives you visual feedback on how much 
host processing an algorithm uses. Two meters are provided - one for 
peak use, and one for average use. 


The update rate of these meters is set in the Ticks page of the Prefer- 
ences dialog; the default rate is 30 Ticks, equal to 1 /2 of asecond. 


This meter shows the average host processing being used by the algo- 
rithm. Different Macintosh models have varying amounts of processing 
power, and so results depend on which one is being used. 


This shows the greatest amount of host processing used by the algo- 
rithm. 
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Run Time 


Algorithm 
Statistics 
Module Version 

Run Time Version 
Signature 

Dsp version 


Number Of Images 


host 
hostLin 
hostCirc 


Patch Statistics 
Number Of Patches 


algorithm statistics 


The Run Time window shows algorithm statistics, so that you can keep 
track of the resources used by an algorithm. The most important items 

here are the code sizes, the amount of memory used, and the number of 
host processes. Enjoy! 


The current version number of the dsp module. 

The current version number of the SynthKit Macintosh host routines. 
The dsp module for which the code has been compiled. 

The version number of the dsp chip. 


The number of dsps used for the algorithm. 


Dsp Statistics 


These stats are provided for each dsp being used. The first number in 
the line of text is the number of the dsp. 


The size of the dsp code. 

The amount of x memory used. 

The amount of y memory used. 

The amount of y circular memory used. 


The amount of circular memory used (this memory is used for delay- 
based blocks). 


The amount of linear memory used (this is table memory). 
The number of inputs to the dsp. 

The number of outputs from the dsp. 

The number of interrupts used in the dsp. 

The number of tables used in the dsp. 

The number of delays running on the dsp. 

The number of linear memory accesses per sample. 


The number of circular memory accesses per sample. 


Host Statistics 
The size of the host code. 
The amount of host linear memory used. 


The amount of host circular memory used. 


The number of separate patches in the algorithm. 


Under the Number of Patches parameter, the statistics for each Patch 
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are given separately. 


(Patch Number) The first number in the line represents the Patch to which these statis- 
tics apply. 
Number Of Voices How many voices are played by the Patch. 
dsp The number of the dsp on which the Patch is running. This is only rele- 
vant for multi-dsp systems. 
Number Of Routines This is the number of host functions running for the Patch. 
host These six values show the host routines, broken down by processing 


rate. The first is the number of dsp-assist demand processes; the second 
is the number of host demand processes; and the last four are the num- 
bers for host 1, 2, 3, and 4 respectively. 


Number Of Triggers The number of independent processing streams in the Patch. 


Dsp Statistics Host Statistics Algorithm Statistics 


SSS 015 test 2: kw ie SSE 
a 


Module Version: O Run Time version: 11 Signature: 'x013' bsp version: 0 
Humber OF Images: 2 
O: code 34 (349 «26 y6 yCir 0 lin 2048 cir 0 fin:0 out:1 int:0 thls:1 dlys:0 lina:1 cira:0 
1: code 30 (503 x26 y 5 yCir 0 lin :0 cir 441 ine] out: int:0 thls 0 dlys:1 lina:0 cira:3 
host 4S hostlin 2046 hostCire 0 
Murmber OF Patches: 3 
> Aurmber Of Voices: 1 
O: dep:0 Number Of Routines: O host= 00000 0 Number Of Triggers: 0 
> Murmber Of Voices: 1 
Ddsp:0 Number Of Routines: 3 host= 3540000 Number Of Triggers: 3 
>Aumber Of Voices: 1 
Ddép:1 Number Of Routines: 14 host= 464000 Number Of Triggers: 3 


Patch Statistics Host Routines 


Run Time Window 
Everything you always wanted to know about memory! 


Linear and Circular Memory 


Some SynthKit platforms also provide hardware support for delay 
lines, known as circular memory. This hardware support makes delay 


1. But were afraid someone might actually take the time to tell you. 
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Run Time 


Host Resources 


algorithm statistics 


lines much less computationally expensive, but also means that the cir- 
cular space can only be used for delay-based processes. Linear memory 
is basically “normal” memory, which in SynthKit is used primarily for 

tables and samples. 


Some types of memory - for instance, the standard DRAM used in com- 
puters and samplers - are slow enough so that a computer will ask for a 
piece of data, do something else for a couple of instructions, and then 
come back when the memory has finally returned with the requested 
data. Many systems also use a small amount of SRAM, a type of mem- 
ory which is very fast but also very expensive, for situations in which 
the waiting period for DRAM would be problematic. SynthKit’s x and y 
memory are always in SRAM; depending on the target platform, the 
other memory types may be either SRAM or DRAM. 


SynthKit is designed to support large amounts of circular and linear 
memory (for long delay lines, tables, and samples); SRAM would be 
prohibitively expensive in these quantities, and so the less expensive, 
slower DRAM is used instead. In some cases, though, it will be desir- 
able to have small, quickly-accessed delay lines - for creating filters, for 
instance. Y memory is thus divided into two parts - a normal y, and a 
circular y (called yCirc). 


So, what about the host platforms? Well, we’re glad you asked. The 
only currently supported host is the Macintosh, although SynthKit is 
designed to be able to support other host systems in the future. The 
Macintosh should have more than enough memory for any host tasks. 
Maximum code size, on the other hand, is a measurement of processing 
power, and that’s somewhat difficult to quantify in this case. It will 
vary greatly depending on the specific Mac model that you're using, 
and on other programs that may take processing power while SynthKit 
is running (such as INITs, or any currently loaded programs which con- 
tinue to run in the background). 


The best way to get to know your system’s host processing potential is 
to keep an eye on the Process Time meters, which show a continual 
read-out of the amount of host processing being used. 
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view and edit samples 


Sample Menu 


Locked 
AutoSend 


Send 
Length... 


Sample 


SynthKit’s Sample window is meant as a simple way to view sample 
data, and is not intended to replace a dedicated sample editor. It is 
assumed that those who are involved in serious use of PCM will also 
be using a sample editing program such as Digidesign’s Sound 
Designer II, or the currently unsupported Alchemy. 


Cut and paste of sample regions, for instance, is not supported. You 
can, however, edit data on a sample-by-sample basis by drawing in the 
Graph display or entering numbers in the text displays, similar to edit- 
ing a Table. 


SynthKit will play phase-coherent stereo samples, in addition to mono 
samples. In the Graph display, both channels of a stereo sample are dis- 
played. 


If you use certain special characters in the name of a Sample (such as 
()™! etc.), they will be displayed as “\” in the Block editor popup 
menus. 


Downloading Sample Edits 


Sample edits can be automatically downloaded to the host or dsp by 
turning on the Sample menu’s AutoSend option. If this is not turned on, 
then you must manually update the dsp or host after editing, using the 
Send command (also in the Sample menu). 


Minimum Loop Length 
Nix reference to X013 


A minimum loop length will be required to assure that Samples are 
played back properly. This minimum length, which can be entered in 
the Sample Preferences (in the File menu), is quite small - currently, 
only 8 samples. 


If the Use Minimum Loop Length parameter (also in Sample Prefer- 
ences) is selected, importing a Sample will automatically check to make 
sure that its loop is long enough. 


Selecting this locks the Sample. 


When this option is selected, the Sample will be automatically down- 
loaded to the dsp whenever changes are made. 


Downloads the Sample to the dsp (use this if AutoSend is turned off). 
Selecting this item brings up the Length dialog box. 


Length. This sets the number of steps in the Sample’s x axis. If you add 
length to a pre-existing Sample, the new space is filled with zeros. 


Sample Rate Convert. This feature may eventually allow adjusting the 


1. These programs are fine for those who are only serious PCM users, but 
problem users - or abusers - should seek professional help. 
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Sample 


Bandlimit... 


Display Menu 


Graph 


Decimal 


view and edit samples 


length of a Sample without changing its shape. It is not implemented 
yet. 


This function may be used to smooth out a Sample; selecting it brings 
up the Bandlimit dialog box. 


Bandlimiting is a filtering function; it takes a range, or window, of the 
Sample (specified by the Length parameter) surrounding the current 
point, and uses all of the points within the window to determine a 
value for the current point. The importance of each point across the 
window may be weighted equally, or those closer to the current point 
may be given greater weight; this is determined by the Window Shape. 


Frequency. Similar to the cutoff frequency of a filter, this works in con- 
junction with Length to determine the amount of smoothing. The lower 
the frequency, the greater the smoothing. Try values of 0.1 or less. 


Length. This parameter determines the length of the bandlimiting win- 
dow (how many Samples are looked at for the filtering of each point). 
The greater the length, the greater the smoothing. Try lengths of 100 or 
more (100 is the default). 


Window shapes. The shape of the bandlimiting window determines 
the relative importance of the points within the window. The Rectangu- 
lar shape weights all of the points equally, whether they are close to the 
center point or just at the edges of the window; this will tend to cause 
more averaging to occur, and suppress local variations. The other 
options, including Hanning, Hamming, and Blackman, are preferable 
to Rectangular; they weight points closer to the center more heavily, 
allowing more local variations. You may not notice much of a difference 
between the various shapes, but experiment and see what you think! 


Rectangular. This weights all points within the window equally. 


Hanning. This is an alternate window shape. Play with it and see 
what happens. 


Hamming. This is another alternate window shape. Try it out, if 
you like. 


Blackman. This is yet another alternate window shape. 
Limit. This option limits the output of the Sample to -1.0 and +1.0. 


Normalize. This option normalizes the output of the bandlimiting, so 
that the maximum deviation of the waveform is 1. 


Samples can be displayed and edited using five different formats: 
graphically, as decimal numbers, as hexadecimal numbers, as floating- 
point numbers (on a scale of -1.0 to +1.0), and in exponential notation. 
Note that Samples may be edited in any format; to edit in the numerical 
displays, just click on a value and enter a new number. 


Shows the Sample as a graph. 


Each value is shown discretely as a decimal number. 
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Hexadecimal 
Float 


Exponential 


Magnitude 
Phase 


Terrace 


Channel (n) 


Magnification 
Menu 


Label Menu 


None 
Time 


Samples 


Key Shortcuts 


option-click and drag 


Sample 


Each value is shown discretely as a hexadecimal number. 
Values are shown in floating-point format, on a scale of -1.0 to +1.0. 


Displays values in exponential notation; this can be convenient for 
showing very small numbers. 


This option is not implemented for the OASYS PCI. 
This option is not implemented for the OASYS PCI. 


The Graph display defaults to showing straight-line interpolations 
between the points of the Sample. For Samples with very few points, 
this may be misleading; the Terrace option displays the Sample without 
smoothing, as if each point was a step in a staircase. 


The graph display will show both channels of a stereo Sample simulta- 
neously, but the text displays (decimal, hexadecimal, float, etc.) can 
show only one channel at a time. This parameter chooses which chan- 
nel will be shown. For mono Samples, this will always be set to channel 
1. 


The Graph display can show the Sample at 13 levels of magnification, 
from +64 (full zoom in) to x64 (full zoom out). These different views 
allow you to zoom in to view small details, or zoom out for a general 
overview of the Sample. 


This menu affects only the Graph display; it is not relevant for the text 
formats. 


The center line in the Graph display represents time; it can be labeled in 
milliseconds or samples, or just left blank. 


No labels are added to the time line. 
The time line is measured in milliseconds. 


The time line is measured in samples. 


Draws a straight line from the last click position (in the Graph display). 
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The Samples List shows the Samples stored in the current SynthKit file. 
In addition to those stored in the file, there are also Constant and Global 
Samples. Constant Samples (whose names are prefixed with “c”) are 
stored within SynthKit, and cannot be edited; Global Samples are 
stored in your preferences file, and can be edited. For more information, 
please see “Constant...” on page 45, and “Global...” on page 68. 


=> rubble: Samples List: techno = 
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Pages allow you to organize the Samples into groups. To go to a new 
page, just click on its button or select it from the Page menu; this will 
also select the page for renaming, deleting, etc. 


You can add new Samples and new pages by using the Grow command 
(3£G). If a Sample is currently selected, then SynthKit will automati- 
cally grow another Sample; if not, then a dialog box will appear, asking 
what you want to grow (select “Item” for anew Sample, and “Page” for 
anew page). Another dialog box will prompt you to name the new 
page or Sample. 


To rename the selected page or Sample, use the Rename command 
(38 =); to delete the selected page or Sample, use Ungrow (38U). 


You can change the order of the list by clicking on a Sample’s name and 
dragging it to anew position; similarly, just click and drag on a page 
button to change the order of the pages. To move a Sample to a different 
page in the list, copy and paste into the new page (and then use 
Ungrow to delete it from the original page). 


When this is checked, no edits can be made to the window (including 
growing, ungrowing, and renaming pages and Samples). 


This shows a list of all the pages in the window, so that you can select 
them by name. You can also select pages by clicking on the page num- 
ber buttons, at the top left of the window. 
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List of Samples 


Samples List 


This lists all of the single Samples (as opposed to MultiSamples) stored 
in the file. There are also separate lists of Global and Constant Samples, 
as mentioned above. 
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Table Menu 


Locked 
AutoSend 


Send 


Selection... 


create and edit tables 


The Table window allows you to generate and edit Tables in many dif- 
ferent ways. You can draw them in the Graph display (the x-y position 
of the mouse is shown in the status line); you can generate them from 
complex equations, or from a set of breakpoints; you can even copy and 
paste data from word processors and spreadsheets. 


Table edits can be automatically downloaded to the host or dsp by turn- 
ing on the Table menu’s AutoSend option. If this is not turned on, then 

you must manually update the dsp or host after editing, using the Send 

command (also in the Table menu). 


Tables can be useful, but they take up valuable memory (especially 
when used on the dsp), so try not to use too many of them. In many 
cases, you may be able to duplicate the effects of a Table by using the 
Tracking, Math, or Polynomial blocks. 

As with all user names, if you use certain special characters in the name 
of a Table (such as ;()”! etc.), the characters will be displayed as “_” in 
any menus. 


Table Length 


For Tables used with continuous values on the host and dsp, lengths 
must be in powers of 2 (256, 512, 1024, etc.). On the host, the minimum 
length is 256, and values up to 8192 have been tested and verified; the 
various dsps each have their own requirements (for details, see the 
Host and DSP Specifics chapter on page 222). 


Tables used with enumerated values may be of any (reasonable) length. 
All Tables in a Table-based block must be the same length. 


You can change the length of a Table, even after entering data into it. If 
the new length is greater than the old, the new space is filled with zeros. 


Tables as Text 


You can paste text data from a spreadsheet or word-processor into a 
Table; points can be separated by commas, spaces, returns, or tabs. 


Tables may also be saved in a text format, for exchanging data with 
other programs. For more information, see the File menu’s Save As 
command, on page 14. 


Selecting this locks the Table. 


When this option is selected, the Table will be automatically down- 
loaded to the dsp whenever changes are made. 


Downloads the Table to the dsp (use this if AutoSend is turned off). 


You can use command-drag to select a portion of a table, or use this dia- 
log to set the selection start and end times manually. You can also use 
this dialog to fine-tune a selection range created by command-drag- 


ging. 
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Length... 


Equation... 


Table 


Start. The beginning of the selection, measured in points on the x-axis. 
End. The end of the selection, measured in points on the x-axis. 
Selecting this item brings up the Length dialog box. 


Length. This sets the number of steps in the Table’s x axis. If you add 
length to a pre-existing Table, the new space is filled with zeros. 


Still not implemented. This would be cool to do. 


Sample Rate Convert. This feature may eventually allow adjusting the 
length of a Table without changing its shape. It is not implemented yet. 


We should mention how equation can be affected by the 
unipolar setting. Any equation involving x will take x from 
-1 to 1 if we are bipolar, or 0 to 1 if we are unipolar. Equa- 
tions have no effect on the table unless the user clicks OK in 
the equation dialog. The equation associated with the table 
is not ‘live’. 

This brings up the Equation dialog box. You can generate a new Table 


from a mathematical function, or process the current Table through an 
equation. 


If part of the table is selected, the selected area will be replaced, while 
the rest of the table is left untouched. If there is no selected area, the 
entire table will be replaced by the output of the equation. 


When writing Table equations, “A” is the input to the Table and “B” is 
the current Table value. Thus, to scale an existing Table by two, use the 
equation “B*2.0.” 


Limit. This option limits the output of the Table to -1.0 and +1.0. 


Equation. All math block functions can be used (for a complete list, see 
the entry for the Math block on page 157). There are a number of addi- 
tional functions available only in Table generation, as listed below. 


If the equation is phrased incorrectly, SynthKit will beep and bring up 
the message, “Parse Error.” SynthKit may take some time to calculate 
the results of an equation; you can abort in the middle of a long calcula- 
tion by pressing #6 -period. 


Note that the trigonometric functions sine, cosine, and tangent operate 
on 7x, while all other functions (including other trigonometric func- 
tions such as hyperbolic sine, arcsine, etc.) operate simply on x. 


Examples of Valid Equations 
A+0.5 


(A-B)*0.3 
squ(A)+0.3*A+0.1 
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pow(A,B)*0.5 
exp(0.9/ A) 
In(A+B) 
min(A,B,0.1) 


Table-Only Math Functions 


The following functions are available for Table generation only (i.e., 
they are not recognized by the Math block). 


acos (arccosine). acos(x) computes the arccosine of x. 
asin (arcsine). Computes the arcsine of x. 
atan (arctangent). This is the arctangent of x. 


cos (cosine). This operates on mx, instead of simply x, so that cos(x) 
delivers the cosine of 1x. 


cosh (hyperbolic cosine). This computes the hyperbolic cosine of x. 


exp (exponential base e). exp(x) is e*, or e to the power of x; e is the 
square root of 2, approximately 1.41421. 


exp2 (exponential base 2). exp2(x) is 2”. 

exp10 (exponential base 10). exp10(x) is 10*. 

log2 (logarithm base 2). The logarithm base 2 of x. 
log10 (logarithm base 10). The logarithm base 2 of x. 
In (logarithm base e). The logarithm base e of x. 


noise(). Noise takes no arguments, but make sure to include the double 
parenthesis, as in A+noise(). 


sin (sine). As with cos and tan, sin(x) computes the sine of mx. 
sinh (hyperbolic sine). The hyperbolic sine of x. 


sqrt (square root). sqrt could indeed be a lemon-lime soft drink, but 
instead it delivers the square root of x. 


tan. This computes the tangent of mx. 


tanh (hyperbolic tangent). The hyperbolic tangent of x. This function is 
useful for creating s-shaped distortion, or flute model curves. 


A (power). A‘B is A raised to the power of B; 243, then, is 2 cubed, or 8. 
Note that the squ (square) function is available in host and dsp math 
blocks. 


pow (power). This performs the same function as the “”””, but uses a 
different syntax; pow(x,y) is x/y. 


bow and reed. Bow and reed both have four arguments. The first is the 
input, the second the threshold, the third the slope, and the fourth the 
curvature. The larger the slope parameter, the faster the drop. A curva- 
ture of 1.0 is linear, <1.0 concave up, >1.0 down. Standard Tables are 
generated by: bow(A,0.3,2.0,1.0) or reed (A,-0.7,1.0,1.0). 
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Bandlimit... 


Table 


This function may be used to smooth out a Table; selecting it brings up 
the Bandlimit dialog box. If part of the table is selected, bandlimiting 
will be applied to the selected area only; if there is no selected area, the 
entire table will be bandlimited. 


Bandlimiting is a filtering function; it takes a range, or window, of the 
Table (specified by the Length parameter) surrounding the current 
point, and uses all of the points within the window to determine a new 
value for the current point. The importance of each point across the 
window may be weighted equally, or those closer to the current point 
may be given greater weight; this is determined by the Window Shape. 


Again, this is the normalized digital frequency : real fre- 
quency divided by sample rate. 


Frequency. Similar to the cutoff frequency of a filter, this works in con- 
junction with Length to determine the amount of smoothing. The lower 
the frequency, the greater the smoothing. Try values of 0.1 or less. 


Length. This parameter determines the length of the bandlimiting win- 
dow (how many samples are looked at for the filtering of each point). 
The greater the length, the greater the smoothing. Try lengths of 100 or 
more (100 is the default). 


Window shapes. The shape of the bandlimiting window determines 
the relative importance of the points within the window. The Rectangu- 
lar shape weights all of the points equally, whether they are close to the 
center point or just at the edges of the window; this will tend to cause 
more averaging to occur, and suppress local variations. The other 
options, including Hanning, Hamming, and Blackman, are preferable 
to Rectangular; they weight points closer to the center more heavily, 
allowing more local variations. You may not notice much of a difference 
between the various shapes, but experiment and see what you think! 


Rectangular. This weights all points within the window equally. 


Triangular. The Triangular window weights the center at 1 and 
decreases linearly to 0 at the edges. 


Hanning. This is an alternate window shape. Play with it and see 
what happens. 


Hamming. This is another alternate window shape. Try it out, if 
you like. 


Blackman. This is yet another alternate window shape. 
Limit. This option limits the output of the Table to -1.0 and +1.0. 


Normalize. This option normalizes the output of the bandlimiting, so 
that the maximum deviation of the waveform is 1. 


We should probably emphasize the fact that there is a 
noise() function built into the equation part above where 
one can build more complicated results out of noise. 
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This command brings up the Noise dialog box, from which you can add 
noise to an existing Table. If part of the table is selected, the noise will 
be added to the selected area only; if there is no selected area, the noise 
will be added to the entire table. 


Noise. This controls the amount of noise added to the Table. The value 
is the maximum amount of deviation that the noise will add to the 
Table, expressed in floating-point format. For instance, if the Noise 
amount is set to 1.0, then the noise will add or subtract up to 1.0 (half 
the height of the Table) for each point. 1.0 is a pretty high setting; for 
more subtle variations, try something in the range of 0.01 to 0.1. 


Limit. When checked, this keeps the noise within the vertical bounds of 
the Table; values are clipped to fit between -1.0 and +1.0, in floating 
point format. 


This brings up the Breakpoints dialog box, allowing you to add, delete, 
and edit Breakpoints. You can also add Breakpoints by control-clicking 
in the Graph display - thus, you might pick the important points in a 
Table, and then create a new Table from those breakpoints using the 
Generate command, described below. 


These will be used to specify known points from which SynthKit can 
interpolate the rest of the Table, for tuning tables, etc. 


To see the breakpoints in the Table graphic, select the Breakpoints 
option in the Display menu. 


Input. This is the input value to the Table (the horizontal axis of the 
Graph display) for the current breakpoint. When this value goes into 
the Table, the result is the Output value set below. 


Output. The output value corresponds to the vertical axis of the Graph 
display; it is the value sent out when the Input value, set above, is 
received by the Table. 


Add. Adds a new breakpoint with the current input and output set- 
tings. 


Delete. Deletes the currently selected breakpoint. 


Clear, Sort and Update still aren’t implemented. Should we 
implement these things? 

Clear. Clears all breakpoints; this is not implemented yet. 

Sort. Sort isn’t implemented yet. 

Slider. This slider always edits the output of the current breakpoint. 
Update. Update isn’t implemented yet. 


This command generates a new Table using the current set of Break- 
points. If part of the table is selected, the selected area will be replaced, 
while the rest of the table is left untouched. If there is no selected area, 
the entire table will be replaced. 
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Tune... 


Display Menu 


Graph 
Decima 
Hexadecima 


Float 


Exponential 


Terrace 


Breakpoints 


Table 


Note that bipolar /unipolar setting from the display menu 
will affect the range over which the table is gener- 
ated.Again, the breakpoint / generation isn’t ‘live’ so chang- 
ing the polarity on the display after the generation has no 
affect on the table data. 


Interpolation Options. Three interpolation options are available. Note 
that this interpolation is used for calculating the Table only, and has no 
affect on the playback interpolation of a Table block. 


Linear. This simply draws straight lines between Breakpoints - 
otherwise known as the “connect-the-dots” option. A minimum 
of two Breakpoints are required. 


Quadratic. Quadratic plots the curve at each point using the 
three closest points; a minimum of three Breakpoints are required 
for this function. 


LaGrange. This option uses all of the Breakpoints to plot a 
smooth curve. A minimum of three Breakpoints is required. 


Extrapolate. If this box is checked, and the list of breakpoints does not 
include values for the extreme left- and right-hand sides of the table, 
then the generated table will be extended to the sides using the last 
specified slope or curve. 


If Extrapolate is not checked, the table will be extended to the sides 
with horizontal lines from the left- and right-most breakpoints. If val- 
ues for the extreme left- and right-hand sides are already specified by 
breakpoints, the Extrapolate option has no effect. 


This parameter is not supported for OASYS PCI. 


Tables can be displayed and edited using five different formats: graphi- 
cally, as decimal numbers, as hexadecimal numbers, as floating-point 
numbers (on a scale of -1.0 to +1.0), and in exponential notation. Note 
that Tables may be edited in any format; to edit in the numerical dis- 
plays, just click on a value and enter a new number. 


Shows the Table as a graph. 

Each value is shown discretely as a decimal number. 

Each value is shown discretely as a hexadecimal number. 

Values are shown in floating-point format, on a scale of -1.0 to +1.0. 


Displays values in exponential notation; this can be convenient for 
showing very small numbers. 


The Graph display defaults to showing straight-line interpolations 
between the points of the Table. For Tables with very few points, this 
may be misleading; the Terrace option displays the Table without 
smoothing, as if each point was a step in a staircase. 


With this item checked, Table breakpoints will be shown as heavy black 
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Unipolar 


Key Shortcuts 


command-drag 


Delete key 
option-click 


control-click 


create and edit tables 


dots in the Graph display. If this is not checked, the breakpoints will be 
invisible. 

This sets the range of the horizontal (x) axis to 0.0-1.0, essentially chop- 
ping off the left half of the normal Table. 

Unipolar is added at the end. When it is checked, the axes 
are displayed so that the table appears plotted against input 
value ranging from 0 to 1. The generate... and equation... 
operations are affected by the current polarity setting. 


The idea is that the polarity of the table is NOT a property 
of the table itself. There are various ways that any given 
table can be interpreted, and that interpretation is set in the 
table block, where the table is used, not here. It is here to 
help design tables that are ultimately intended to be used 
as unipolar in a table block. The only effect of setting unipo- 
lar here is to move the display axes in the graph mode, and 
to affect how tables are generated from equations in the 
equation dialog. 


Selects a portion of the table, for use with the clear, equation, bandlimit- 
ing, generate, and noise functions. 


Clears the selected portion of the table. 
Draws a straight line from the last click position (in the Graph display). 
Enters a new Breakpoint (in the Graph display). 
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Tables List 


The Tables List shows the Tables stored in the current SynthKit file. In 
addition to those stored in the file, there are also Constant and Global 
Tables. Constant Tables (whose names are prefixed with “c”) are stored 
within SynthKit, and cannot be edited; Global Tables are stored in your 
preferences file, and can be edited. For more information, please see 
“Constant...” on page 45, and “Global...” on page 68. 


== rubble: Tables List: betty = 
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Pages allow you to organize the Tables into groups. To go to a new 
page, just click on its button or select it from the Page menu; this will 
also select the page for renaming, deleting, etc. 


You can add new Tables and new pages by using the Grow command 
(3£G). If a Table is currently selected, then SynthKit will automatically 
grow another Table; if not, then a dialog box will appear, asking what 
you want to grow (select “Item” for a new Table, and “Page” for a new 
page). Another dialog box will prompt you to name the new page or 
Table. 


To rename the selected page or Table, use the Rename command (3£=); 
to delete the selected page or Table, use Ungrow (36 U). 


You can change the order of the list by clicking on a Table’s name and 
dragging it to anew position; similarly, just click and drag on a page 
button to change the order of the pages. To move a Table to a different 
page in the list, copy and paste into the new page (and then use 
Ungrow to delete it from the original page). 


When this is checked, no edits can be made to the window (including 
growing, ungrowing, and renaming pages and Tables). 


This shows a list of all the pages in the window, so that you can select 
them by name. You can also select pages by clicking on the page num- 
ber buttons, at the top left of the window. 
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This lists all of the single Tables (as opposed to MultiTables) stored in 
the file. There are also separate lists of Global and Constant Tables, as 
mentioned above. 
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SynthKit algorithms are constructed by connecting various different 
blocks together, a lot like patching together the different modules of an 
old-fashioned modular synthesizer. There are a large number of Synth- 
Kit blocks, including basically any functions that you might find on an 
ancient moog system - such as filters, oscillators, mixers, and envelopes 
- in addition to many others designed for PCM playback, physical mod- 
eling, and other synthesis tasks. This chapter explains some general 
concepts common to all blocks, and then lists all of the individual 
blocks in alphabetical order, explaining each of their functions in detail. 


SynthKit supports several different host and dsp platforms, each with 
its own capabilities and limitations. For each platform, a given block’s 
features may vary slightly; in some cases, it may not be implemented at 
all. For information on how a block works on a particular platform, 
please see the chapter Host and DSP Specifics, on page 222. 


Blocks 
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Block Processing the dsp, or both 


SynthKit blocks all create or process data in some way; depending on 
the particular block, this processing may be done on either the dsp or 
the host computer (currently, the Macintosh CPU). For certain blocks, 
processing may be done on both simultaneously. 


The dsp can do many computations much faster than the host, which 
allows it to deal with audio signals as well as extremely rapid, smooth 
controller signals; the host is slower, but is still good for dealing with 
envelopes, lfos, and most other tasks whose times are measured in mil- 
liseconds instead of microseconds. The host is also good for tasks which 
happen only infrequently, such as updating controller values. 


There are five different update rates for the host. Four of these - Host 1, 
2, 3, and 4 - are updated on a constant basis, with Host 1 updated most 
frequently and Host 4 updated at a much slower rate (the actual rates in 
milliseconds are set in the Execution window). These allow you to save 
processing power by experimenting with coarser and finer resolution 
LFOs, envelopes, and so on. 


The fifth option is Host Demand, which updates only when necessary 
(or when the block’s services are “demanded”); this is useful for MIDI 
notes and controllers, some triggered blocks (such as envelopes and 
smoothing filters) which don’t need to run constantly, and other infre- 
quently-changed values. 


Each block has two menus, Type and Calculation, which determine 
whether the block is calculated on the host, on the dsp, or on both. Type 
controls the block’s core processing; Calculation controls secondary 
processing, and its functions will vary from block to block. 


You can use the available options to make trade-offs between the host 
and dsp, freeing up computation time on one or the other, with the goal 
of optimizing your resource use. 


Some blocks may run only on the host, or only on the DSP. 


Also, some blocks may have menu options of ports which work only on 
the host, or only on the DSP. 


Signal Path Affects Block Processing 


Although you can adjust the processing options for each block, Synth- 
Kit may sometimes override your choices during compilation (you'll be 
notified if this happens). This is because each block’s processing is, at 
least to some extent, dependent on the blocks before it in the signal 
flow. In general, a block should have an equal or faster processing rate 
than those before it. 


For instance, if a dsp oscillator is processed through a filter, that filter 
must operate on the dsp as well - otherwise, it simply couldn’t keep up! 
Slower rates can be used for auxiliary, modulation signal paths, how- 
ever - for instance, the cutoff of the filter could be controlled by a host 
demand slider. 


The Propagate On Change option, explained below, allows you to work 
around these rules in certain cases. 
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the dsp, or both Block Processing 


Type Menu 


Each block’s Type menu specifies whether its core processing will be 
done on the host or the dsp. Additionally, if the block is used on the 
host, then one of several update rates may be selected. The various 
options are explained below. 


You can access this menu from the block editor, or by Control-clicking 
on a block in the algorithm window. 


Dsp. The block will be executed on the dsp. For control blocks, such as 
envelopes and lfos, this will mean that the signal will be smoother and 
be able to change more rapidly than when done on the host; the trade- 
off is that sometimes, there may not be enough dsp power to spare. 


In the Algorithm window, Dsp blocks are colored pink. 


Host Demand. The block will be executed on the host, and will only 
use processing power when its state changes; for instance, a System 
Receive block set to Pitchbend would only be calculated when the 
pitch-bender is moved, and otherwise would be skipped. This is usu- 
ally more efficient than the other host options, and should generally be 
used for modulators such as note, aftertouch, etc. 


In the Algorithm window, Host Demand blocks are colored white. 


Host 1, 2, 3, 4 (Host Synchronous). The block will be executed synchro- 
nously on the host, and the value will be updated at the Host 1, 2, 3, or 
4 rates, as set in the Execution window. This option uses host process- 
ing power constantly; lower update rates use less processing, but are 
more coarse. These options can be used for host filters, lfos, and so on. 


In the Algorithm window, Host synchronous blocks are colored blue. 


Propagate On Change. This option works in addition to the choice of 
dsp, host demand, or host 1/2/3/4. As noted above, blocks usually 
must be of equal or faster processing speeds than those before them in 
the signal path. However, the Propagate On Change option allows you 
to alter this in some circumstances, by making it so that only new val- 
ues are sent out from the block. It can also be used for optimization, to 
reduce the amount of redundant processing in an algorithm. 


Propagate On Change makes sense in certain situations, two of which 

are given below; in these cases, it can save processing power for blocks 
later in the signal path, or allow connections which would otherwise be 
impossible. It adds a certain amount of processing to the block in which 
it is used, however, and should thus be used with some discretion. It is 
most efficient when you expect a value to change very infrequently, but 
can cause a net gain in processing if the value changes too frequently. 


For instance, take a look at figure 1 below. 
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HD=Host Demand 
POC=Propagate On Change 


4: slider 


HD + POC 


1: system receive 2: math a: table 
Modulation wheel maxt4 0.93 


Propagate On Change - fig. | 


The Math block in this algorithm will send out whichever value is 
greater: the output of the mod wheel, or 0.9. That means that, until the 
mod wheel is at the very top of its range, the Math block’s output will 
always be 0.9. If the Math block were simply host demand, it would 
send a value to the Mix block whenever the mod wheel was moved, 
causing the Mix block and Table to be calculated every time. 


If Propagate on Change is set, however, the Math block will calculate 
the result, compare it to the last output, and only send a value to the 
Mix block if it is different than the last one. Since the result will nor- 
mally be 0.9, most of the time the Mix and Table blocks will not receive 
new values, and will not need to be recalculated - saving on processing 
power. 


HD=Host Demand 
DSP=Dsp 
POC=Propagate On Change 


DSP DSP + POC 


10: oscillator 12: threshold 13: envelope 


Propagate On Change - fig. 2 


The figure above shows a different application of Propagate On 
Change. A dsp Oscillator is being fed through a rectifier (in the Math 
block), and then to a Threshold block. When the signal to the Threshold 
block reaches a certain level, its output changes from 0 to 1. 


If Propagate On Change were not turned on, the Threshold block - run- 
ning on the dsp - would output a value every sample, regardless of 
whether or not the value had changed. With it turned on, the Threshold 
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Calculation 
Menu 


Block Processing 


only sends output when the threshold is reached, cutting down the 
data rate so that it can be handled by a host demand block - in this case, 
an envelope, using the output of the Threshold as a trigger (for an auto- 
wah effect, for instance). 


The Calculation menu controls the secondary processing rate for the 
block. “Secondary processing” is a catch-all category, which has differ- 
ent meanings for each block of each host & dsp system; in some cases it 
means a part of the processing for a dsp block which may be done on 
the host, and in other cases it may mean the update rate of a Host 
Demand block. Many blocks have no secondary processing rate at all. 
Since each block’s implementation can vary (slightly) for each host & 
dsp target system, the function of the Calculation menu for each block 
is noted in the Host & Dsp Specifics chapter, on page 222. 


With some dsp processes, the host may assist the dsp by doing some of 
the auxiliary work; this is true for dsp envelopes, for instance. If a par- 
ticular block can use host assistance, then the Calculation menu decides 
whether to use host assistance (if set to Host 1/2/3/4 or Host 
Demand), or do all of the computation on the dsp (if set to dsp). The 
options here are the same as those of the Type menu, above, except for 
the omission of Propagate on Change. 


This selection allows you to make a trade-off of where the processing is 
done; off-loading some processing to the host can free up some extra 
dsp instructions. 


When using the Host Demand Type with triggered blocks - such as 
envelopes and smoothing filters - you still need to specify an update 
rate. The idea is that Host Demand makes the blocks lie dormant until 
they are triggered - so that they don’t take up any processing time - but 
once they are triggered, they need to be updated at a constant rate, such 
as Host 1/2/3/4. The Calculation menu is used to set this secondary 
update rate. 
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block numbering can 


Block Numbering affect a patch's sound 


Unlike the components of a physical system, SynthKit’s blocks do not 
operate simultaneously; they each perform their function in turn. 


Each block is marked with a number at its lower left corner, denoting its 
place in the order of operations. The blocks are originally marked in the 
order in which they are placed down; the Number command, in the 
Algorithm window’s Block menu, allows this numbering to be 
changed. 


The block marked #1 performs its function first, then the block marked 
#2, and so on. This order of operations can sometimes have an affect on 
the sound, as described below. 


Default Values of Ports 


A block’s ports are used to pass audio or modulation data to or from 
the block. Normally, the input ports receive values from other blocks, 
and the output ports send out values resulting from the block’s signal 
processing functions. There are two exceptions to this, however. 


If there is no connection to an input port, the default value for that port 
is used instead. You may often have parameters which you do not wish 
to modulate; in that case, entering a default value sets the parameter to 
a specific amount, which will be used unless and until a modulator 
source is connected. 


If a block’s port is polled by another block before any computation has 
taken place, the default value for that port is used. This will generally 
only happen at the very beginning of the sound. For instance, in the 
example below, a simple oscillator-filter patch is fed to an output. The 
blocks are numbered entirely backwards, with the output block #1, the 
filter #2 and the oscillator #3. 


4: oscillator 2: filter 1: audio cutput 
1 


oscillator oscillator filter 
first data default value default 
value 


Sample 0 


rani oscillator oscillator filtered 
P second data > first data ——® version of 
oscillator 
default value 


oscillator oscillator filtered 

third data second data version of 
oscillator 
first data 


Sample 2 
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block numbering can 
affect a patch's sound 


Block Numbering 


Order of Operations - Backwards 


The first block to function is the audio output block. It looks back up 
the signal path at the output of the filter. Since the filter has not yet 
made any computations, it sends out the default value of its output 
port. 


Next is the filter’s turn to function, so it looks back up the signal path to 
the oscillator. Since the oscillator has yet to be calculated, it sends out 
the default value of its output port to the filter, and the filter carries out 
its processing on that value. Finally, the oscillator is calculated, and 
stands ready with its first real data. 


When the audio output port is calculated for the second time, it looks 
back up the signal chain to the filter, which passes on its current value - 
the processed version of the oscillator’s default output. The second cal- 
culation of the filter operates on the first data of the oscillator, and then 
the oscillator calculates its second data. 


It is not until the third sample that the audio output receives any real 
data from the oscillator. This is, then, not the best way to set up the 
block numbering. 


In the below example, the blocks are numbered so that the oscillator is 
calculated first, then the filter, and then the audio output. Notice that, 
unlike the previous example, the oscillator data makes it to the output 
with no sample delays, and the default values of the oscillator and filter 
are not used. 


oscillator 2: filter 2: audio qutput 
1 
filtered 
— version of 
oscillator 
first data 


oscillator oscillator 


SAMplO Os -cectdais aust data 


Sample 1 oscillator oscillator filtered 
second data — second data version of 
oscillator 
second data 


oscillator oscillator filtered 

third data third data version of 
oscillator 
third data 


Sample 2 


Order of Operations - Correct 
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Port Parameters 


Name 


Type 


Memory 


Allocate Specify 
Allocate Memory 


Location H 


Location V 


Internal Format 


each port has its own settings 


All ports - input or output, control or audio - share a common set of 
parameters. Clicking on the name of a port within a block, or double- 
clicking / $8 -clicking on a port icon in the Algorithm window, brings up 
a dialog box containing the port’s parameters, as detailed below. Some 
of the parameters are editable from this dialog box; others are view- 
only. 


This is the name for the port. Enter anything you like (such as “Elmo” 
or “Wanda’”); this is especially useful in the Algorithm and Patch 
blocks, or comments to be seen from the Algorithm window (the port 
name is displayed in the Algorithm window’s status line). 


There are two separate choices for port type, each with two options; 
Continuous or Enumerated, and Input or Output. 


Continuous. The port will accept floating-point numbers between -1 
and +1 (on the dsp) or -256 and +255 (on the host). 


Enumerated. The port will accept only integers, 0 and above. 


For some blocks, this is a read-only parameter; in others, it is user-con- 
figurable. 


Block. The port will use the block’s processing type (dsp, host demand, 
or host 1/2/3/4). 


Host. Manually forces the port to be executed as host demand. For 
example, the Reset port of an Oscillator can be executed on either the 
host or the dsp. In most cases, SynthKit will take care of this for you 
(and it therefore will be read-only). 


Allocate Specify must be set to False when working with OASYS PCI. 
This parameter is not implemented for use with OASYS PCI. 


This is the horizontal location of the port, expressed as an arbitrary 
floating-point number (so that resizing a block will retain the ports’ rel- 
ative positions). The left-hand side of the block is equal to 0, and the 
right-hand side is equal to 1. 


This is the vertical location of the port, expressed as an arbitrary float- 
ing-point number (so that resizing a block will retain the ports’ relative 
positions). The top of the block is equal to 0, and the bottom is equal to 
1. 


This sets the numerical format of the port value, as used in SynthKit’s 
calculations. In most cases, the user shouldn’t change this; however, 
you may want to do so when creating ports for an Algorithm or Patch 
block. 


Decimal. The value is expressed as a 24-bit integer, centered around 0. 
8,388,608 decimal = 1.0 float. You can use this format for both enumer- 
ated and continuous ports (as opposed to Float, which is for continuous 
ports only). 


Hexadecimal. Values are in Hex (base 16); Hex $7FFFFF = +1.0 Float. 
This can be better than float for viewing small numbers very precisely, 
since it is closer to the actual number system of the computer. It may 
take some getting used to, though... 
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each port has its own settings 


Display Format 


Port Parameters 


Float. Floating-point numbers; this is the standard format. On the dsp, 
these are -1.0 to +1.0; on the host, these can be greater. 


Exponential. Uses exponential notation. For example, a small number 
might be displayed as “1.23e-5;” this means 1.23 * 10°, or 
1.23 * 0.00001, which is equal to 0.0000123. 


Parameter. This is most useful for the Display Format, as opposed to 
the Internal Format. It allows you to display a parameter in familiar 
synth-style formats, such as 0-10, 0-100, etc. The port’s value is com- 
puted using the equation, (value-min) /(max-min)*parameter limit, 
using the minimum and maximum values from this window, and the 
parameter limit from the General page of the Preferences dialog. For 0- 
100 ranges, set the parameter limit to 100. 


Parameter +-. Similar to Parameter, but displays from -100 to +100 
(again, using the parameter limit from the General page of the Prefer- 
ences dialog). 


dB. This translates the amplitude values into dB. 


Pitch Linear. This is the native format of Receive Note. Most of the 
time, blocks expect this value to be converted through an exponential 
table. 


Pitch Exponential. Used for the pitch of oscillator blocks, hammers, etc. 
Pitch Hertz. Shows the frequency of the current field. 


Pitch Number. This is based on the MIDI note number of the pitch 
(with additional fractions for intermediate values). 


Pitch Name. Shows pitch name plus cents for intermediate values. 
Length Linear. Don’t use this. :-) 


Length Exponential. Can be used for the pitch of delay blocks, includ- 
ing cylinders, tubes, echoes, etc. Often, you may wish to use Samples or 
Milliseconds instead. 


Samples. This can be used for delay line lengths; it shows the number 
of samples in the delay (time*sample rate). 


Milliseconds. This is the default format for delay-based blocks. 


Centimeters. This uses the Preferences parameter, “Speed of Sound,” to 
convert from time to distance. Use it for really slick looking reverb algo- 
rithms - we'll all be truly impressed. 


Wet/Dry. This is similar to Parameter +, except that at 0 “Dry” is dis- 
played, and at 100 “Wet” is displayed. Normally, the “Complement” 
option should also be enabled when using this setting. 


Beats Per Minute. Shows the frequency of the current field. 


ANDY WILL SAY. 


This sets the format in which the port values are displayed. The Display 
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Port Parameters 


Number of Digits 


Value 


Minimum 


Maximum 


Connecttion 


each port has its own settings 


Format can be different from the Internal Format; you might, for 
instance, have a port whose Internal Format is Pitch Exponential, but 
which is displayed in Hertz. The choices here are the same as those for 
the Internal Format, above. 


This set the display resolution of the port - how many digits are used to 
display its value. This does not change the actual value itself. 


This is the current value of the port. 


The minimum value of the slider in the block editor. This does not affect 
incoming signals to the port. 


The maximum value of the slider in the block editor. This does not 
affect incoming signals to the port. 

There is now a check box with the label ‘Break Trigger’ 
below maximum. ANDY SAYS: Don’t know if this works 
anymore. CHECK WITH DAVE: still implemented? CHAR- 
LIE SAYS: still used. 


for host code, suppresses propogate on change. For 
instance, two control streams merged together; change one, 
but only propogates when other control is moved (eg Bank 
Select) 


Read-only display for the Port now includes... 


The maximum value of the slider in the block editor. This does not 
affect incoming signals to the port. 


Connection: 
<connection port here> 


The connection (if it exists) names another block and port 
that this port is connected to. This will only happen for 
ports in connection, algorithm or patch blocks that are used 
to ‘pipe’ data between sub-algorithms or patches using con- 
nection blocks. 


and ... 
Symbol: 


<symbol here> 
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each port has its own settings Po rt Pa ram et ers 


The symbol shows where the port “lives,” how many times 
it is referenced (connected to) by other ports, and where the 
port has been allocated in memory. 
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Addin 


| 
ca 


Ports 


name 


inputLeft, inputRight 
outputLeft, outputRight 


hammer 


Menus 
addin(n) 


invert(n) 


insert a signal 
into a physical model 


The Addin block is used to insert a hammer pulse, or other stimulus, 
into a physical modelling system. The output of the stimulus is con- 
nected to the hammer input port on the top of the Addin block. 


Name this block anything that you like. 
Min value: -1.0 Max value: +1.0 


These are the default values for the inputLeft and inputRight audio 
ports. 


Min value: -1.0 Max value: +1.0 


These are the default values for the outputLeft and outputRight audio 
ports. 


Min value: -1.0 Max value: +1.0 


This is the default value for the hammer input port. If a hammer or 
other audio source is connected to this port, that audio is added to the 
signals flowing through the Addin. 


Normal. This menu selects the type of Addin to be used; currently, only 
the Normal type is available. 


This feature inverts the shape of the hammer pulse added to either or 
both of the outputs. This may be used as a shortcut for switching an 
end of a physical modelling system from positive (a gain block) to neg- 
ative (a junction block). 


None. No inversion occurs. 
Left. The hammer added to the left output is inverted. 
Right. The hammer added to the right output is inverted. 


Both. The hammer is inverted for both outputs. 


Addin Block Diagram 


hammer 
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create a high-quality, 
dsp-based envelope 


ADSA 


Ports 


name 


gate 


output 


attack 
decay 


sustain 


release 


ADSR 


The ADSR block creates a high-quality, dsp-based, analog-style enve- 
lope. The sound is designed to match that of the envelope generator on 
classic analog synthesizers - fast, smooth, and punchy, with natural cur- 
vature. 


Note that the Envelope block (as described on page 138) provides a 
more flexible envelope, with additional envelope segments. It is not as 
high-quality as the ADSR block, however. 


ADSR Rates 


Rate values are equal to the distance between 0 (min) and 1 (max) trav- 
eled over a single sample. For instance, with a rate of 0.1, the envelope 
moves 1/10th of the distance between 0 and 1 every sample; in 10 sam- 
ples, the journey is complete. 


(This is a little simplified, since the envelopes include natural curva- 
ture.) 


Another way of thinking of this is that the rate sets the amount of 
change in amplitude (increase or decrease) per sample. 


Larger numbers mean faster rates; slower rates need very small num- 
bers. 0.01 creates a time of about 2ms; 0.0000005 creates a time of about 
42 seconds. Set the min and max of control panel sliders accordingly! 


Enter any name you like. 


This port expects the Gate message, which it uses to trigger the start of 
the Envelope (on key down, for instance) and begin the release phase 
(on key up). 


Min value: -1.0 Max value: +1.0 


This is the default value for the output port. 


Min value: -1.0 Max value: +1.0 


This is the rate at which the envelope rises from zero to maximum 
amplitude, when triggered by the gate input. 


Min value:0 Max value: +1.0 


This is the rate at which the envelope falls from the maximum level (at 
the end of the attack) to the sustain level. 


Min value:0 Max value: +1.0 


This is the amplitude level of the sustain segment. 


Min value:0 Max value: +1.0 


This is the rate at which the envelope decays to zero after the gate is 
released. 


And there’s more! 


‘precision:’ is anew menu for ADSR. There are two choices 
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ADSR 


create a high-quality, 
dsp-based envelope 


in the menu. ‘Single Precision’ and ‘Double Precision’. 
These affect to number of bits in the math used to calculate 
the rates of attack, decay and release. For very, verylong 
decay or attack times (minutes), the single precision case 
might not arrive to 0 or 1 - especially if linearity is very low. 
To get around this, you can either turn on double precision, 
turn linearity to at least 0.1 (helps with attack only), or limit 
the envelope times to shorter values. This means that with a 
very long, exponential attack (linearity near 0), it may stall 
at just under 1.0 and hang forever. 


Linearity - port that is set at 0.3 by default (typical of early 
analog envelopes). This only affects the attack time. 0 is 
exponential, and 1 is linear. 
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condense an algorithm 
into a single block 


Block Edit 


window - Ports 


name 


connection input(s) 


connection output(s) 


Algorithm 
window 


Algorithm 


This block represents a merged algorithm, containing one or more 
blocks and/or ports. Ports are created by placing the connectInput and 
connectOutput blocks within the Algorithm. 


You can either create an Algorithm block and then place other blocks 
inside it, or select a number of pre-existing blocks to be merged into an 
Algorithm. For more information, please see the Merge command in 
the Algorithm window’s Block menu, on page 40. 


The Algorithm block can be grown in two dimensions: connection 
input and connection output. Each adds an input or output port to the 
Algorithm block, and adds a corresponding connection block within 
the Algorithm itself. 


Command-clicking brings up the Block Edit window (the normal block 
editor); double-clicking opens the block up into the Algorithm window, 
so that you can view and edit the algorithm itself. 


If the option and control keys are held down when adding an Algo- 
rithm or Patch block, you can import the algorithm from another Synth- 
Kit file. 


Give the algorithm a descriptive name. 


This is the value for an input port. Note that ports are numbered by 
their place in the order of operations. 


This is the value for an output port. Note that ports are numbered by 
their place in the order of operations. 


Double-clicking on an Algorithm block opens it up so that you can edit 
the algorithm’s patch, just as you would a top-level SynthKit patch. 
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Allpass 


Ports 


name 


input 

output 

a(n) 
Constants 
shift a(n) 


Grow Options 


a 


allpass filter 


The Allpass is a generic filter, similar to the Arma block; you can poke 
in filter coefficients directly. Unlike the Arma block, however, SynthKit 
will automatically calculate the denominator (feed-back) coefficients 
based on the user’s numerator (feed-forward) coefficients. 


Just as with the Arma block, you can easily design filters that will blow 
up. 


Enter any name you like. 

Min value: -1.0 Max value: +1.0 

This is the value for the filter’s input port. 
Min value: -1.0 Max value: +1.0 


This is the value for the filter’s output port. 


Min value: -1.0 Max value: +1.0 


This is a feed-forward coefficient. 


multiply a(n) by 2/shift describes the operation. 
Min value: 0 Max value: +e 


This scales the corresponding feed-forward coefficient, to create values 
outside the range of -1.0 to +1.0. 


This adds another feed-forward coefficient. 
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allpass filter for reverbs 


i zo ‘i 


filter 


amount 


Menus 


interpolate 


Allpass Delay 


The Allpass Delay provides dispersion without coloration (if the low- 
pass filter is not used). It can be used to create reverbs. 


This block cannot be grown. 


Enter any name you like. 
Min value: -1.0 Max value: +1.0 


This is the value for the input port. 


Min value: -1.0 Max value: +1.0 

This is the value for the output port. 
Min value: 0.0 Max value: +1.0 

This scales the delay time, as set below. 
Min value: 0.0 Max value: +1.0 


This sets the cutoff of the 1-pole lowpass filter in the feedback loop. 


Min value: -1.0 Max value: +1.0 


Feed-forward and feedback amount. Usually, the amount should be 
positive (the risk of blowing up is greater with negative numbers, 
depending upon the DC coupling). 


Interpolation improves the quality of the audio. There are four basic 
types of interpolation, each of which can be performed entirely on the 
dsp or with the assistance of the host. Using host-assisted interpolation 
frees up some Dsp code space, but should only be used when you don’t 
want to modulate delay times at audio rate. Ratio modulation for host 
interpolated delays must be done by host blocks. 


None. No interpolation. 


None Host. No interpolation, but the host helps out by calculating off- 
set. 


Linear. This uses simple straight-line interpolation. Linear interpolation 
is less computationally expensive than Allpass or LaGrange3 (below). 


Linear Host. Similar to Linear above, but the host calculates offsets and 
interpolation parameters. This is less computationally expensive than 
Allpass or LaGrange3 (below). 


Allpass. This option uses a constant table to provide high-quality all- 
pass filtering. It is somewhat more computation-intensive than Linear 
(above), but provides a flat frequency response. 


Allpass Host. This is the same as Allpass above, except that offsets and 
interpolation parameters are calculated on the host. 


LaGrange 3. This interpolation method uses three points for the inter- 
polation. The frequency response is better than linear, but still not per- 
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Constants 
delay (n) 


correction 


Al i P ass D el ay allpass filter for reverbs 


fect. This is the most computationally expensive interpolation method. 


LaGrange 3 Host. Same as LaGrange 3 above, except that the coeffi- 
cients are calculated on the host. 


Four more interpolation menu choices: 


‘Fast Linear’ - in normal interpolation, grab sample (n) and 
then grab (n+1), and do the interpolation. For Fast interpo- 
lation, grab the last sample coming out of the delay line, 
delay by one sample, and then interpolate. Function is 
identical, but reduces memory reads and adds 1 sample of 
delay. For a fixed tap, this is the preferred method. For a tap 
which is being modulated quickly, this might introduce 
errors - use normal instead. 


‘Fast Linear Host’ - similar except that interpolation coeffi- 
cient is calculated on the host. Fine if fixed; will have more 
zippering than Fast Linear if being modulated. 


‘Fast Allpass’ - allpass interpolation, but caches previous 
delay output. 


‘Fast Allpass Host’ - see above. 


Min value: 0.0 Max value: limited by available memory. 
This is the delay, in milliseconds, of delay number (n). 


The default value for this parameter is taken from the algorithm’s Exe- 
cution window, which is in turn derived from your Preferences file. If 
you'd like to change this, just go to the Execution page of the Prefer- 
ences dialog. 


For proper tuning at 44.1 kHz when using delays instead of a cylinder 
in a physical modelling system, use the default delay length of 
22.67574. 


Min value: 0.0 Max value: +e 


This is a pitch-correction option, which can be used to compensate for 
the total delay of a system (in samples). The default value is 0, which 
causes the correction to be optimized out. If you insert a filter into the 
loop, it will introduce a small amount of extra delay, which will affect 
the tuning. To compensate for this, try entering a correction amount of 
0.25, or 0.5. This is a “tweaky” parameter - play with it until it sounds 
right. 
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allpass filter for reverbs Al i p ass D e i ay 


Allpass Delay Block Diagram 


amount 
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amount | 
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Arma 


Ports 


name 


input 
output 


numerator 0 


numerator(n) 


denominator(n) 


Constants 
shift numO 


shift num(n) 


shift den(n) 


design your own filter 


The Arma block is a generic filter block - roll your own coefficients. 
You can easily design filters that will blow up. 


The Arma can be grown in two dimensions, “numerator” and “denom- 
inator.” Growing “numerator” will add another pair of numerator(n) 
and shift num(n) parameters; Growing “denominator” adds another 
pair of denominator(n) and shift den(n) parameters. This allows you to 
add additional coefficients to the filter. 


Enter any name you like. 
Min value: -1.0 Max value: +1.0 


This is the value for the filter’s input port. 


Min value: -1.0 Max value: +1.0 

This is the value for the filter’s input port. 
This is the DC input to the filter. 

Min value: -1.0 Max value: +1.0 


This is the numerator (feed-forward) coefficient of pair (n). 


Min value: -1.0 Max value: +1.0 


The denominator (feed-back) coefficient of pair (n). 


Min value: 1 Max value: +e° 


This is the amount of shift for the DC input to the filter; shift is a quick- 
and-dirty multiplication by factors of two. This option enables you to 
have coefficients greater than one by pre-scaling the coefficient down, 
but telling the compiler to shift the result back up. 


Min value: 1 Max value: +e° 


This is the amount of shift for coefficient a(n); shift is a quick-and-dirty 
multiplication by factors of two. This option enables you to have coeffi- 
cients greater than one by pre-scaling the coefficient down, but telling 
the compiler to shift the result back up. 


Min value: 1 Max value: +e0 


This is the amount of shift for coefficient a(n). As described under shift 
a above, shift is a computationally inexpensive multiplication by factors 
of two, which enables you to fake the system into creating coefficients 
greater than one. 
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use external sounds 
in SynthKit 


Menus 


channel 


type 


Constants 


ramp 


Audio Input 


The Audio Input block allows you to get outside audio-rate signals 
into SynthKit. You can use this for actual audio (for effects processing, 
for instance), or for ultra-high-rate controllers. 


This block cannot be grown. 


Enter any name you like. 
Min value: -1.0 Max value: +1.0 


This is the default value for the output audio port. Values outside the 
range of the port will be clipped. 


This is the audio channel from which the block takes its input. The 
choices will vary depending on the selected module. For the OASYS 
PCI module, the choices are analog left and right, s-pdif left and right, 
and adat 1-8. 


When a new input block is added, this parameter is set to the first avail- 
able channel. 


This selects the filtering used for the audio. 

Flat. No filtering. 

DC Cut. Filters out DC in the signal (for correcting an offset). 
two new menu choices are... 

(WHAT DO THESE DO? ANDY, He know not....) 


‘Flat A/D’ 
‘DC Cut A/D’ 


When running or stopping an algorithm, SynthKit fades the audio in or 
out; this parameter sets how long the fade in/out takes. 
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output sound 


Aud i °o oO ut p ut from an algorithm 


Ports 


name 


input 


Menus 


channel 


type 


Constants 


ramp 


The Audio Output block is used to bring the sound out of the algo- 
rithm. 


This block cannot be grown. 


Enter any name that you like. 
Min value: -1.0 Max value: +1.0 


This is the default value for the input audio port. Input at this port will 
be sent to the specified output channel. 


This is the audio channel to which the output will be sent. The choices 
will vary depending on the selected module. For the OASYS PCI mod- 
ule, the choices are analog left and right, s-pdif left and right, and adat 
1-8. 


There are two types of audio outputs: normal and dual. 
Normal should be used for the first dsp. 
Dual should be used for the second dsp. 


‘Mono’ is now a third menu choice. 


There is now a ‘kind’ menu. The choices are 
‘Dynamic Summation’ - 

‘Static Summation’ 

‘Direct’ 


Not currently used for OASYS PCI. 


When running or stopping an algorithm, SynthKit fades the audio in or 
out; this parameter sets how long the fade in/out takes. 
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audio-quality oscillator Aud i o Oo Sc i il at or 


The Audio Oscillator block is used to create and audio-quality oscilla- 


tor. 


This block cannot be grown. 


AUDIO OSCILLATOR 


NEEDS drive table connected to drive port; pulse width for saw does nothing; for pulse, it does as normal 
(goes from -1.0 to 1.0; 0 is square, -1.0 is all min, and 1.0 is all max); for 
triangle wave, -1.0 shifts peak of triangle to the left (earlier), 0.0 is nor- 
mal, 1.0 shifts peak to the right(later); as the peak of the triangle shifts, 
the amplitude decreases, going to 0 at the extremes. You may wish to 
disable pulse for the triangle. 


Drive: controls the sharpness of the waveform edges (brightness / aliasing). Must be scaled carefully, using 
a drive table. 
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Bow 


Ports 


user name 


inputLeft, input Right 
outputLeft, outputRight 
velocity 


pressure 


threshold 
scale 


crossfade 


create a physical 
model of a bow 


This block is used to create a physical model of a bow without using a 
poy 8 

table. Avoiding tables saves on precious table memory, and also allows 

you to run the algorithm on a platform which doesn’t support tables. 


This block cannot be grown. 


Enter any name that you like. 
Min value: -1.0 Max value: +1.0 


These are the default values for the inputLeft and inputRight audio 
ports. 


Min value: -1.0 Max value: +1.0 


These are the default values for the outputLeft and outputRight audio 
ports. 


Min value: -1.0 Max value: +1.0 


This parameter represents the velocity of the bow moving across the 
string. It interacts with pressure to affect volume and timbre. 


Min value: -1.0 Max value: +1.0 


This parameter represents the pressure of the bow pushing down on 
the string. It interacts with velocity to affect volume and timbre. When 
pressure is 0, the bow will have no effect (this makes sense, if you think 
about a bow moving over a string - but not pressing down at all). 


Min value: -1.0 Max value: +1.0 


This is the point at which the bow function begins its slope (see the dia- 
gram below). 


Min value: 0.0 Max value: +1.0 


This sets the length of the slope for the bow function (see the diagram 
below). 


Min value: 0.0 Max value: +1.0 


Eventually, this will allow you to crossfade between functions 1 and 2 
in real time. For now, it doesn’t work. 
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create a physical 


model of a bow Bow 


Bow Function Diagram 


scale 
shape of 


slope is 
v7 determined 
: by “function” 


: — 


threshold 


Menus 


bow For now, there is only a single choice here (welcome to totalitarian mod- 
elling! Please feel free to choose any Bow you like...). 


Bow. Please to choose. 


function | This controls the slope of the function for the bow block (see the Bow 
Function Diagram above). 


Linear. This is a simple, straight line. 


Quadratic Up, Quadratic Down, S Up, S Down. Please see the Bow 
Function Slope Diagrams below (a picture is more eloquent here). 


function2 This does not work yet. Eventually, you will be able to use the crossfade 
parameter to fade between functions 1 and 2 in real time. 


Linear. This is a simple, straight line. 


Quadratic Up, Quadratic Down, S Up, S Down. Please see the Bow 
Function Slope Diagrams below (a picture is more eloquent here). 
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Bow 


Constants 
shift 


Bow Block 
Diagram 


create a physical 
model of a bow 


Bow Function Slope Diagrams 


Quadratic Up 


Quadratic Down 


Min value:0 Max value: +e° 


This is a factor-of-two multiplier for the scale parameter, which sets the 
length of the slope. This allows you to fake the program into creating 
scales greater than one. 


Y Pressure 


X)> &) > 
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create a physical model 
of a bow, using a table 


Ports 


name 


inputLeft, input Right 
outputLeft, outputRight 


select 


position 
velocity 


pressure 


Menus 


bow 


interpolate 


Bow Table 


This block is used to create a physical model of a bow, using a table. 


You can grow more MultiTables for the Bow Table block. 


Enter any name that you like. 
Min value: -1.0 Max value: +1.0 


These are the default values for the inputLeft and inputRight audio 
ports. 


Min value: -1.0 Max value: +1.0 


These are the default values for the outputLeft and outputRight audio 
ports. 


Min value:0 Max value: +e° 


The Bow Table block can only actually use a single MultiTable at a time. 
However, you can use the grow command to add more MultiTables, 
which appear as MultiTable 1, MultiTable 2, etc.; this parameter then 
allows you to select between them. 


MultiTables cannot be selected in real time on the Macintosh host. 
However, you can use the position port (below) in real time to select 
between the tables contained in a MultiTable. 


Min value: 0.0 Max value: +1.0 


This selects the table to be used from the current MultiTable (based on 
key position, for instance). 


Min value: -1.0 Max value: +1.0 


This parameter represents the velocity of the bow moving across the 
string. It interacts with pressure to affect volume and timbre. 


Min value: -1.0 Max value: +1.0 


This parameter represents the pressure of the bow pushing down on 
the string. It interacts with velocity to affect volume and timbre. When 
pressure is 0, the bow will have no effect (this makes sense, if you think 
about a bow moving over a string - but not pressing down at all). 


The shape of the bow. There is currently only a single choice here. 


Normal. This is the standard bow type. Please to choose. Don’t worry, 
you'll like it. 

Interpolation improves the smoothness of the table, and thus also the 
quality of the audio. 

None. No interpolation. 


Linear. This is the simplest form of interpolation; it draws a straight 
line between the two points to be interpolated. This is less computa- 
tionally expensive than Quadratic or LaGrange3 (below). 
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create a physical model 


Bow Table of a bow, using a table 


Linear Wrap Around. This handles the interpolation at the last part of 
the table. When this option is selected, the end of the table will be inter- 
polated against the start of the table. This makes sense for a periodic 
table. 

‘Linear wrap around’ is now the third choice in this menu. I 
don’t believe it is implemented for the bow table. 


multitable (n) You can select the MultiTable to be used for the bow. Use the grow com- 
mand to add more MultiTables. 


Bow Table 
Block Diagram 


Y Pressure 


XK) &) > 
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create an input port 


for an algorithm or patch C onn ect : on ll Nn p ut 


This block is used to create an input port for a merged Algorithm or 
— Patch. ConnectionInput blocks can only be placed within an Algorithm 

or Patch block; they cannot be placed in the root-level algorithm. 

The type (Dsp, Host, etc.) of the port created by the ConnectionInput is 

controlled by the type of the ConnectionInput block itself. 


ConnectionInput blocks can be automatically created by dragging an 
output wire onto an Algorithm or Patch block. 


Ports 
name Name the connection as you wish - but avoid giving identical names to 
two ports on the same block. Changing this name will also change the 
name of the corresponding port on the Algorithm block. 
output Min value: -1.0 Max value: +1.0 


This is the default value for the output port. Values at this port are 
passed on to the input port created on the parent Algorithm or Patch. 
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create an output port 


Cc on nectionOutput for an algorithm or patch 


This block is used to create an output port for a merged Algorithm or 
i Patch. ConnectionOutput blocks can only be placed within an Algo- 

rithm or Patch block; they cannot be placed in the root-level algorithm. 

The type (Dsp, Host, etc.) of the port created by the ConnectionOutput 


is controlled by the type of the ConnectionOutput block itself (as set in 
the Type menu). 


ConnectionOutput blocks can be automatically created by dragging an 
input wire onto an Algorithm or Patch block. 


Ports 
name Name the connection as you wish - but avoid giving identical names to 
two ports on the same block. Changing this name will also change the 
name of the corresponding port on the Algorithm block. 
input Min value: -1.0 Max value: +1.0 


This is the default value for the input port. Values at this port are 
passed on to the output port created on the parent Algorithm or Patch. 


The connection output now has ‘Menu’s ‘type’ and ‘kind’. 


They are identical to the ‘type’ and ‘kind’ menus in the 
audio output block. There are also two ‘Constant’ fields, 
‘channel’ and ‘ramp’. 
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the heart of the 
physical model 


Ports 


name 


input left, input right 


output left, output right 


ratio 


addin ratio (n) 


addin (n) 


pressure ratio (n) 


pressure (n) 


Menus 


length interp 


Cylinder 


The Cylinder block is the heart of a physical modelling system; it may 
be used to model a resonating string, the tubing of a wind or brass 
instrument, and so on. The Tube Admittance and Tube Reflection 
blocks are based on the Cylinder block, as well; the three blocks form 
the Bore family (as in the bore of a tube, as opposed to your uncle 
Freddy who tells the endless stories that put everyone to sleep). 


Name the block as you please. 
Min value: -1.0 Max value: +1.0 


These are inputs to the Cylinder. 


Min value: -1.0 Max value: +1.0 


These are the outputs from the Cylinder. 


Min value: 0.0 Max value: +1.0 


This is the length of the Cylinder; 1.0 is equal to the constant parameter, 
“delay” (set below). It expects Note input, processed through the 
cExpLength2000 constant table. 


Min value: 0.0 Max value: +1.0 


This determines the position of addin (n) within the Cylinder; the value 
is an arbitrary number, such that 1.0 is equal to the total length of the 
Cylinder (the same as length, above). This allows you to inject an addin 
at any position within the Cylinder. 


Min value: -1.0 Max value: +1.0 
This is the input port for addin (n). 
Min value: 0.0 Max value: +1.0 


This determines the position of pressure output (n) within the Cylinder; 
the value is an arbitrary number, such that 1.0 is equal to the total 
length of the Cylinder (the same as length and addin ratio, above). Use 
this to make taps out of the Cylinder from specific positions. 


Min value: -1.0 Max value: +1.0 


This is the port for pressure output (n). 


Interpolation improves the quality of the audio. There are several basic 
types of interpolation, each of which can be performed entirely on the 
dsp or with the assistance of the host. Using host-assisted interpolation 
frees up some Dsp code space. 


This is the interpolation for the basic output of the Cylinder. 
None. No interpolation. 


None Host. No interpolation, but the host helps out by calculating off- 
set. 
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Cylinder 


addin interp (n) 


pressure interp (n) 


the heart of the 
physical model 


Linear. This uses simple straight-line interpolation. Linear interpolation 
is less computationally expensive than Allpass or LaGrange3 (below). 


Linear Host. Similar to Linear above, but the host calculates offsets and 
interpolation parameters. This is less computationally expensive than 
Allpass or LaGrange3 (below). 


Allpass. This option uses a constant table to provide high-quality all- 
pass filtering. It is somewhat more computation-intensive than Linear 
(above), but provides a flat frequency response. 


Allpass Host. This is the same as Allpass above, except that offsets and 
interpolation parameters are calculated on the host. 


LaGrange 3. This interpolation method uses three points for the inter- 
polation. The frequency response is better than linear, but still not per- 
fect. LaGrange 3 is the most computationally expensive interpolation 
method. 


LaGrange 3 Host. Same as LaGrange 3 above, except that the coeffi- 
cients are calculated on the host. 


There is also now... 
‘Fast Linear’ 

‘Fast Linear Host’ 
‘Fast Allpass’ 

‘Fast Allpass Host’ 


This is the interpolation for addin (n). 
None. No interpolation. 


None Host. No interpolation, but the host helps out by calculating off- 
set. 


Linear. This uses simple straight-line interpolation. 


Linear Host. Similar to Linear above, but the host calculates offsets and 
interpolation parameters. 


This is the interpolation for pressure output (n). 
None. No interpolation. 


None Host. No interpolation, but the host helps out by calculating off- 
set. 


Linear. This uses simple straight-line interpolation. Linear interpolation 
is less computationally expensive than Allpass or LaGrange3 (below). 


Linear Host. Similar to Linear above, but the host calculates offsets and 
interpolation parameters. This is less computationally expensive than 
Allpass or LaGrange3 (below). 


Allpass. This option uses a constant table to provide high-quality all- 
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the heart of the 
physical model 


Constants 
delay (n) 


correction 


Grow Options 


addin ratio 


pressure ratio 


Cylinder 


pass filtering. It is somewhat more computation-intensive than Linear 
(above), but provides a flat frequency response. 


Allpass Host. This is the same as Allpass above, except that offsets and 
interpolation parameters are calculated on the host. 


LaGrange 3. This interpolation method uses three points for the inter- 
polation. The frequency response is better than linear, but still not per- 
fect. Most expensive interpolation method computationally. 


LaGrange 3 Host. Same as LaGrange 3 above, except that the coeffi- 
cients are calculated on the host. 


New choices are: 
‘Fast Linear’ 

‘Fast Linear Host’ 
‘Fast Allpass’ 

‘Fast Allpass Host’ 


Min value: 0.0 Max value: limited by available memory. 
This is the delay, in milliseconds, of delay number (n). 


The default value for this parameter is taken from the algorithm’s Exe- 
cution window, which is in turn derived from your Preferences file. If 
you'd like to change this, just go to the Execution page of the Prefer- 
ences dialog. 


For proper tuning at 44.1 kHz, use the default delay length of 22.67574. 
Min value: 0.0 Max value: tee 


This is a pitch-correction option, which can be used to compensate for 
the total delay of a system (in samples). The default value is 0, which 
causes the correction to be optimized out. If you insert a filter into the 
loop, it will introduce a small amount of extra delay, which will affect 
the tuning. To compensate for this, try entering a correction amount of 
0.25, or 0.5. This is a “tweaky” parameter - play with it until it sounds 
right. 


Adds another pair of addin and addin ratio ports, and a corresponding 
addin interpolation menu. 


Adds another pair of pressure and pressure ratio ports, along with a 
corresponding pressure interpolation menu. 
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Delay 


Ports 


name 


input 


ratio (n) 


output(n) 


Menus 


interpolate 


delay signals 


The Delay block can be used for delay effects, including straight 
delays, multi-tap delays, chorus, and flange. It may also sometimes 
serve as a cheap alternative to a Cylinder block. The Delay block may 
be grown in one dimension, “ratio,” which adds new ports in pairs: one 
new ratio and one new output (along with an interpolation menu for 
the new output). This allows you to create multi-tap delays, multi-tap 
choruses, etc. 


Enter any name that you like. 

Min value: -1.0 Max value: +1.0 

This is the default value for the input audio port. 

Min value: 0.0 Max value: +1.0 

This is the default value for the ratio modulation input port (n). 


The ratio scales the delay time; modulating this amount by an LFO can 
be used to create chorus and flanging effects. 


When using the delay as an alternative to a Cylinder block, you should 
process the note signal through the “cExpLength1000” table, and use 
the default delay length of 22.67574. These steps will help to ensure 
proper tuning at 44.1 kHz ina negative-feedback loop. 


You can grow additional ratios. 
Min value: -1.0 Max value: +1.0 


This is the default value for the output audio port. Growing additional 
ratios will also add corresponding output ports. 


Interpolation improves the quality of the audio. There are four basic 
types of interpolation, each of which can be performed entirely on the 
dsp or with the assistance of the host. Using host-assisted interpolation 
frees up some Dsp code space, but should only be used when you don’t 
want to modulate delay times at audio rate. Ratio modulation for host 
interpolated delays must be done by host blocks. 


None. No interpolation. 


None Host. No interpolation, but the host helps out by calculating off- 
set. 


Linear. This uses simple straight-line interpolation. Linear interpolation 
is less computationally expensive than Allpass or LaGrange3 (below). 


Linear Host. Similar to Linear above, but the host calculates offsets and 
interpolation parameters. This is less computationally expensive than 
Allpass or LaGrange3 (below). 


Allpass. This option uses a constant table to provide high-quality all- 
pass filtering. It is somewhat more computation-intensive than Linear 
(above), but provides a flat frequency response. 


132 


Version 4.0, January 2000 Blocks 


delay signals 


Constants 
delay (n) 


correction 


Delay 


Allpass Host. This is the same as Allpass above, except that offsets and 
interpolation parameters are calculated on the host. 


LaGrange 3. This interpolation method uses three points for the inter- 
polation. The frequency response is better than linear, but still not per- 
fect. LaGrange 3 is the most computationally expensive interpolation 
method. 


LaGrange 3 Host. Same as LaGrange 3 above, except that the coeffi- 
cients are calculated on the host. 

Again, this add the four new items mentioned in the inter- 
polation menus in the Cylinder block. 


Min value: 0.0 Max value: limited by available memory. 
This is the delay, in milliseconds, of delay number (n). 


The default value for this parameter is taken from the algorithm’s Exe- 
cution window, which is in turn derived from your Preferences file. If 
you'd like to change this, just go to the Execution page of the Prefer- 
ences dialog. 


For proper tuning at 44.1 kHz when using the delay as a cylinder sub- 
stitute, use the default delay length of 22.67574. 


Min value: 0.0 Max value: +e 


This is a pitch-correction option, which can be used to compensate for 
the total delay of a system (in samples). The default value is 0, which 
causes the correction to be optimized out. 


Meaning... 


If you insert a filter into the loop, it will introduce a small amount of 
extra delay, which will affect the tuning. To compensate for this, try 
entering a correction amount of 0.25, or 0.5. This is a “tweaky” parame- 
ter - play with it until it sounds right. 
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the opposite 


Dist ri butor of the router block 


The Distributor block allows one input to be switched between any 
number of outputs, (just the opposite of the Router block). 

You can connect a Selector to the select port, allowing you to change 

signal routing from the Control Panel. When you first connect the Selec- 


tor a dialog box will appear, asking whether you'd like to update the 
Selector’s labels on the Control Panel. 


The number of outputs may be grown. 


Ports 
name Enter any name that you like. 
input Min value: -1.0 Max value: +1.0 
This is the input port. 
select Min value:0 Max value: number of outputs-1 
This port selects the output to be used. 
output (n) Min value: -1.0 Max value: +1.0 


This is output port(n). 
There is now a ‘Menw’ called ‘reset on write’. The choices 
are ‘On’ and ‘Off’. 


on - zeroes port when moving to another port 


Distributor Diagram 
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delay with feedback 


eae 


Ports 


name 


input 


ratio (n) 


mix(n) 


output(n) 


filter 


feedback 


Menus 


interpolate 


Echo 


The Echo block is a delay with built-in feedback.! 


Echo blocks can be grown in a single dimension, “ratio.” Every Grow 
command adds another ratio, mix, output, and feedback. 


Enter any name you like. 

Min value: -1.0 Max value: +1.0 

This is the default value for the input audio port. 

Min value: 0.0 Max value: 1.0 

This is the default value for the ratio modulation input port (n). 


The ratio scales the delay time; modulating this amount by an LFO can 
be used to create chorus and flanging effects. 


When using the Echo as an alternative to a Cylinder block, you should 
process the note signal through the “cExpLength1000” table, and use 
the default delay length of 22.67574. These steps will help to ensure 
proper tuning at 44.1 kHz, in a negative-feedback loop. 


You can grow additional ratios. 
Min value: 0.0 Max value: +1.0 


Mix controls the relative volumes of the original and delayed signals. 0 
is all delayed signal; 1 is all direct. 


If this is turned off, then the delay output tap will be routed directly to 
the output port. 


If the block has been grown, then each output has its own mix. 
Min value: -1.0 Max value: +1.0 


This is the default value for the output audio port. Growing additional 
ratios will also add corresponding output ports. 


Min value: 0.0 Max value: +1.0 
This is a simple lowpass filter in the feedback loop. 
Min value: 0.0 Max value: +1.0 


This controls the amount of feedback in the delay line. 


Interpolation improves the quality of the audio. There are four basic 
types of interpolation, each of which can be performed entirely on the 
dsp or with the assistance of the host. Using host-assisted interpolation 
frees up some Dsp code space, but should only be used when you don’t 
want to modulate delay times at audio rate. Ratio modulation for host 
interpolated delays must be done by host blocks. 


“any 


1. Doesn't the icon remind you of a truly schnozzled happy face? The “z” is 
the nose... 
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Echo 


Constants 
delay (n) 


correction 


delay with feedback 


None. No interpolation. 


None Host. No interpolation, but the host helps out by calculating off- 
set. 


Linear. This uses simple lowpass filtering for interpolation. This is less 
computationally expensive than Allpass or LaGrange3 (below). 


Linear Host. Similar to Linear above, but the host calculates offsets and 
interpolation parameters. This is less computationally expensive than 
Allpass or LaGrange3 (below). 


Allpass. This option uses a constant table to provide high-quality all- 
pass filtering. It is somewhat more computation-intensive than Linear 
(above), but provides a flat frequency response. 


Allpass Host. This is the same as Allpass above, except that offsets and 
interpolation parameters are calculated on the host. 


LaGrange 3. This interpolation method uses three points for the inter- 
polation. The frequency response is better than linear, but still not per- 
fect. LaGrange 3 is the most computationally expensive interpolation 
method. 


LaGrange 3 Host. Same as LaGrange 3 above, except that the coeffi- 
cients are calculated on the host. 


This interpolation menu has the four new items found in 
the other delay oriented interpolation menus. 


Min value: 0.0 Max value: limited by available memory. 
This is the delay, in milliseconds, of delay number (n). 


For proper tuning at 44.1 kHz when using the delay as a cylinder sub- 
stitute, use the default delay length of 22.67574. 


Min value: 0.0 Max value: +e 


This is a pitch-correction option, which can be used to compensate for 
the total delay of a system (in samples). The default value is 0, which 
causes the correction to be optimized out. If you insert a filter into the 
loop, it will introduce a small amount of extra delay, which will affect 
the tuning. To compensate for this, try entering a correction amount of 
0.25, or 0.5. This is a “tweaky” parameter - play with it until it sounds 
right. 
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delay with feedback 


Echo Block Diagram 


> eb] 


Feedback 


Echo 
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Envelope 


Ports 


name 


trigger 


output 


level (segment #) 


rate (segment #) 


design a complex envelope 


The Envelope block allows you to create envelopes with an arbitrary 
number of segments, each with their own times, levels, and curvatures. 


The Envelope block may be grown in one dimension, “level.” Each 
grow command adds another segment, including parameters for level, 
rate, and curvature. 


Host Envelopes should generally have their Type set to Host Demand, 
with the Calculation menu determining the actual update rate (Host 1/ 
2/3/4). This makes the Envelope more efficient, as it will only be calcu- 
lated when it is triggered. 


Note that the ADSR block (as described on page 111) provides a higher- 
quality, analog-style envelope. It is not as flexible as the Envelope block, 
however. 


Envelope Rates 


Rate values are equal to the distance between 0 (min) and 1 (max) trav- 
eled over a single update period. When calculated on the DSP, the 
update period is a single sample; when calculated on the host, the 
update period is the specified host update rate. 


For instance, on the DSP, with a rate of 0.1, the envelope moves 1/10th 
of the distance between 0 and 1 every sample; in 10 samples, the jour- 
ney is complete. 


Another way of thinking of this is that the rate sets the amount of 
change in amplitude (increase or decrease) per update period. 


Larger numbers mean faster rates; slower rates need very small num- 
bers. 0.01 creates a time of about 2ms; 0.0000005 creates a time of about 
42 seconds. Set the min and max of control panel sliders accordingly! 


Enter any name you like. 


This port expects the Gate message, which it uses to trigger the start of 
the Envelope (on key down) and begin the release phase (on key up). 


Min value: -1.0 Max value: +1.0 

This is the default value for the modulation output port. 

There is now a ‘start segment’ port. I believe this just 
chooses the beginning segment upon trigger dynamically. 


Andy says: start segment - normal case, set to 0; special 
thing happens when set to -1 (controls retriggering) ANDY 
WILL CHECK 


Min value: -1.0 Max value: +1.0 
This is the amplitude value for the specified envelope segment. 


Min value:0 Max value: +1.0 
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design a complex envelope E nve ll  ° ] p e 


This is the rate of the specified envelope segment. This value must be 
an integer. 


Note: for host envelopes using the specific combination of filter type, 
current storage, and update estimate, rate is limited to a maximum of 
0.1 to make triggering more reliable. 


curvature (segment #) Min value: 0.00 Max value: +1.0 


This is the curvature value for the specified envelope segment. 


Menus 


envelope Selects the type of Envelope to be used. 
Ramp. This uses simple linear ramps. 
Ramp Exponential. Approximates exponential curves with ramps. 


Filter. A one-pole lowpass filter, which naturally provides analog-style 
exponential curves. 


Curvature. Dynamically changes ramp values to create curves. 
storage Selects the location in which envelope segment info is stored. 


Current. Only a single segment is stored in the dsp; new segments are 
downloaded as they are needed. 


All. All segments are stored in the dsp. 
update For dsp envelopes only, levels can be updated in two different ways. 


Estimate. The duration of each segment will be estimated by the host; 
after the estimated time has elapsed, the Envelope will go on to the next 
segment. This is less computationally expensive, but has the potential 
to be inaccurate - that is, the Envelope may not have completed the cur- 
rent segment, or may complete the current segment some time before it 
is allowed to progress to the next. For this option, set the Calculation 
menu to Host Demand. 


Poll. The host will monitor the output of the Envelope at the rate speci- 
fied by the block’s Calculation menu; when it has reached its target 
level, it will be allowed to progress to the next. This technique is more 
computationally expensive than Estimate, but more accurate. 


Constants 


attack This is the point to which a looping Envelope returns after hitting the 
sustain segment (although looping is not yet implemented). 


sustain This allows you to set the segment number to sustain upon. If sustain is 
set to 3, for instance, the Envelope will progress to segment 3’s level 
and then stay there as long as the key is held down (assuming that the 
Envelope is triggered by Note on). 
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E q ual y 4 at i on create a parametric filter 


Ports 


name 


input, output 


center(n) 


q(n) 


gain(n) 


The Equalization block provides a fixed parametric EQ filter. 


You can grow this block in one dimension, “center.” Growing creates a 
new set of center, width, and gain parameters. 


Enter any name that you like. 

Min value: -1.0 Max value: +1.0 

These are the default values for the input and output audio ports. 
Min value: 0.0 Max value: 1.0 


This sets the center frequency of the equalization filter. A value of 1.0 is 
equal to the Nyquist frequency of the dsp sampling rate (at 44.1 kHz, 
this is 22.05 kHz). 


Min value: 0.0 Max value: 16.0 
This sets the width of the equalization filter; higher q = smaller width. 
Min value: -1.0 Max value: +1.0 


This sets the amplitude change at the center frequency of the equaliza- 
tion filter. This is not measured in dB, but in SynthKit’s standard ampli- 
tude amounts. 


There will be some problems with extreme equalization (gain <0.25, 
gain >4.0). This will eventually be fixed. 

There is now a ‘type’ Menu for this block. The choices are, 
‘Normal’, ‘Normal Error Feedback’, ‘Pro’, ‘Pro Error Feed- 
back’. I’ll have to look at the code the see what these do. I’d 
imagine they are just different choices of DSP code that 
trade speed for quality. 


Normal - wrong for very wide widths, especially at high 
frequencies. For instance, at 12kHz, a Q of 0.5 will be incor- 
rect. Use this when you wish to modulate the EQ in real- 
time. 


Error feedback - double precision reduces quantization 
noise for lower noise floor 


Pro - fancy coefficients; curves correct at all frequencies and 
widths; cannot be modulated smoothly 
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Filter 


The Filter block can create any of a number of different, real-time mod- 
ulatable filter types. For more filter types, look at the Multimode, Arma, 
Allpass, Equalization, Fir, lir, and Shelf blocks. 


You can grown the filter in a single dimension, Input. Each grow adds 
another pair of inputs and outputs. You can use this for running a num- 
ber of signals (such as two oscillators) through the same Filter. 


Your name here. 
Min value: 0.0 Hz Max value: 24000.0 Hz (1/2 sample rate) 
This sets the cutoff frequency of the Filter. 


When viewed in Float format, avalue of 1.0 is equal to the Nyquist fre- 
quency of the current dsp sampling rate, as set under Parameters in the 
dsp menu. This means that if you change the dsp sampling rate, you 
may need to alter your cutoff frequency as well. If you wish to modu- 
late the Filter with note number, remember to run the note data through 
an exponential table. 


Min value: 0.0 Max value: 1.0 


Resonance works only if the order is set to multiples of 4 (4, 8, 12 etc.), 
and only when the filter is on the dsp. 


Min value: -1.0 Max value: +1.0 


These are the default values for the input and output ports. 


This menu sets the type of Filter to be used. Some of the types are possi- 
ble only on the host; others can be executed on either the host or the 
dsp. For information about the Filter block on a specific target system, 
please see the chapter Host & DSP Specifics, on page 222. 


Cascade. These are constructed of one or more first-order (single pole) 
filters in series, as opposed to optimized algorithms for each filter order. 
They can be executed on either the dsp or the host. 


Cascade Null. Cascade null filters are similar to cascade filters, but they 
additionally have a zero (null) as well as a pole. This gives the filter bet- 
ter response for some extreme settings. They are essentially normalized 
versions of 1.0 minus their flipped version. For example, the cascade 

null highpass is a normalized version of 1.0 minus the cascade lowpass. 


The old program’s cascade lowpass is the new cascade lowpass, while 
the old cascade highpass is the new cascade null highpass. You proba- 
bly will not like the response of the new cascade null lowpass or cas- 
cade highpass as their effects are very subtle, but they will be useful in 
some situations, such as a feedback loop. 


Zero. The Zero type is a simple two point averager (a single zero). This 
is very computationally inexpensive, but is not a very good filter, and 
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should generally be used only for special situations. 


Delay. This is intended to be an allpass filter similar to the ones used 
for delay line interpolation. 


Smoothing Rate. The name is short for “smoothing constant rate.” 
Some users may be familiar with this option in regards to portamento; 
basically, the filter progresses between points at a constant rate, regard- 
less of the distance between the points. Depending how large that dis- 
tance is, the filter will take more or less time to move to the new point. 
This filter is primarily for use with controller data. 


The smoothing filter cutoff is used as a window amount. If the input is 
within the range of the last output +/- the cutoff amount, the input is 
passed through directly, unfiltered. Otherwise, the last output +/- the 
cutoff is passed. 


Smoothing Time. The name is short for “smoothing constant time.” 
Again, some users may be familiar with the term “constant time” in 
regards to portamento; in this case, the filter progresses between points 
at a constant time, regardless of the distance between the points. This 
means that if there is a large difference between the two points, the 
steps may be coarser. The smoothing filters are primarily for use with 
controller data. 


The filter cutoff for the Smoothing Time filter works the same as that for 
the Smoothing Rate filter, as described above. 


Cascade Double. This is similar to the Cascade, but uses 48-bit math 
(double precision). Step responses are more ideal, removing DC offsets 
in some applications. 


new filter types in this menu are... 


‘Shift Double’ - This is a computationally cheap 48bit fil- 
ter.This one is a real hack. You must ‘unuse’ the cutoff, reso- 
nance and set the order to 1 to use it.There is supposed to 
be a ‘shift’ constant in this block, but I don’t see it! Some- 
thing is broken, sigh... 


Double-precision smoothing filter, ensures that critical sig- 
nals reach 0. Fixed cutoff. 


The description of the ‘mode’ menu is correct, but not all 
combinations of type and mode are implemented. 

This determines the mode of the filter type set above. 

Lowpass. Cuts frequencies above the cutoff point. 


Highpass. Cuts frequencies below the cutoff point. For audio-rate 
Highpass filters, it is best to use the Cascade Null filter type. 


Bandpass. Cuts all frequencies except for those around the cutoff (cen- 
ter) point, except for the range set by the filter width parameter. 
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Bandstop. Cuts frequencies around the cutoff (center) point, in the 
range set by the filter width parameter. 


Allpass. Does not boost or cut any frequencies, but delays some fre- 
quencies with respect to the others. This creates dispersion. The cutoff 
frequency controls the dispersion amount. 


Min value: 1 Max value: +e° 


This sets the order, or strength, of the filter. Irst order is (roughly) 6 db 
per octave, 2nd order 12 db per octave, 3rd order 18 db per octave, 4th 
order 24 db per octave, and so on. 


Again, I think there is supposed to be a ‘shift’ constant here. 
I need to find out why I don’t see it. 


TALK TO DAVE - ANDY SUGGESTS FIXED SHIFT 
AMOUNT? 
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The Glottal block creates a pulse wave suitable for seeding a physical 
model of the human voice. The waveform consists of a pulse followed 
by a period of silence; the attack and decay portions of the pulse are 
programmable and modulatable. Unless the attack (periodRising) and 
decay (periodFalling) are modulated, they stay the same as the fre- 
quency changes, so that only the length of the silent portion varies. 


Choose any name that you like. 
Min value: -1.0 Max value: +1.0 


Resets the phase of the glottal pulse. 


Min value: -1.0 Max value: +1.0 


This is the default value for the phase modulation port, which controls 
the phase of the glottal pulse. 


Min value: -1.0 Max value: +1.0 
This is the default value for the output port. 
Min value: 0.0 Hz Max value: 24000.0 Hz (1/2 sample rate) 


This sets the default value for the frequency modulation port, which 
controls the frequency of the glottal pulse. It expects Note Exponential 
as input. 


Min value: 0.0 Hz Max value: 24000.0 Hz (1/2 sample rate) 


This sets the time which the pulse takes to rise to its maximum ampli- 
tude. The total combined time of the rising and falling portions should 
always be less than the frequency; otherwise, the pulse will be re- 
started before it has completed its cycle. 


Min value: 0.0 Hz Max value: 24000.0 Hz (1/2 sample rate) 


This sets the time which the pulse takes to fall from its maximum 
amplitude to the noise portion. The total combined time of the rising 
and falling portions should always be less than the frequency; other- 
wise, the pulse will be re-started before it has completed its cycle. 


This selects the type of glottal pulse to be used; see the diagrams below 
for graphic representation of the two options. 


Glottal 1. The edges of this pulse have a smooth, logarithmic-style 
curve. 


Glottal 2. The edges of this pulse have an s-shaped curve. 
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Glottal | Diagram 


i<— rising o> | <q falling >< silence _ew 


<—_—\_——_ __ waveform loops —____ ¢@@> 


Glottal 2 Diagram 


a) rising —>'~<— falling > '~<— silence —e! 


<—_—_—_\_—\_\_——__ waveform loops ———————__@> 
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The Hammer is used to add an impulse to a physical modelling system 
(in conjunction with an Addin block), or to excite a state-variable filter. 
This version uses a generated hammer shape, as opposed to a table. 


The Hammer block cannot be grown. 


Give the block any name that you like. Try “MC,” for instance. 
Min value:0 Max value: +1 

This input triggers the hammer. 

Min value: 0.0 Max value: 1.0 


This sets the default value of the phase modulation port, which controls 
the phase of the hammer shape. 


Min value: -1.0 Max value: +1.0 
This is the default value for the output audio port. 
Min value: 0.0 Hz Max value: 24000.0 Hz (1/2 sample rate) 


This controls the frequency of the hammer, and expects Note Exponen- 
tial as input. 


Min value: 0.0 Max value: +1.0 


This doesn’t work yet. The idea is to specify the pulse width or symme- 
try of a triangle waveform. 


This determines the shape of the hammer. 


(x-x*x) <<2. This is an approximation of a raised cosine, for a rounded 
hammer shape. 


Peak. This produces a triangular hammer shape. 
Pulse. This produces a single pulse. 


Impulse. This is just a one-sample blip, up and down. 


Hammer Ramps 


See the diagrams below for a graphic look at the hammer ramps. 


Ramp Up Zero. This is a ramp which starts at zero, goes up to one, and 
then returns to zero. 


Ramp Up One. This one starts at zero, goes up to one, and stays there. 


Ramp Down Zero. This one starts at one, goes down to zero, and stays 
there. 


Ramp Down One. This ramp starts at one, goes down to zero, and then 
snaps back to one. 
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Hammer Ramp Diagrams 


Ramp Up Zero Ramp Down Zero 


Ramp Up One Ramp Down One 
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Hammer Table a model, using a table 


The Hammer Table is used to add an impulse to a physical modelling 
system (in conjunction with an Addin block), or to excite a state-vari- 
able filter. In this version of the hammer, a Table is used to create the 
hammer shape; the Hammer block, described on page 146, uses a gen- 
erated shape instead. 


You can grow additional MultiTables for the Hammer Table. 


Give the block any name that you like. 
Min value:0 Max value: +1 

This input triggers the hammer. 

Min value: 0.0 Max value: 1.0 


This sets the default value of the phase modulation port, which controls 
the phase of the hammer shape. 


Min value: -1.0 Max value: +1.0 
This is the default value for the output audio port. 
Min value:0 Max value: +eo 


The Hammer Table block can only actually use a single MultiTable at a 
time. However, you can use the grow command to add more MultiTa- 
bles, which appear as MultiTable 1, MultiTable 2, etc.; this parameter 
then allows you to select between them. 


MultiTables cannot be selected in real time on the Macintosh host. 
However, you can use the position port (below) in real time to select 
between the tables contained in a MultiTable. 


Min value: 0.0 Max value: +1.0 


This selects the table to be used from the current MultiTable (based on 
key position, for instance). 


Min value: 0.0 Hz Max value: 24000.0 Hz (1/2 sample rate) 


This controls the frequency of the hammer, and expects Pitch Exponen- 
tial as input. 


Min value: -1.0 Max value: +1.0 


This has no effect on the hammer output per se. It sends out the level 
amount programmed for the selected table in the multitable, and is 
intended to feed a mixer block. This is similar to the level port in the 
Sample block. 


Interpolation improves the smoothness of the table, and thus also the 
quality of the audio. 


None. No interpolation. 


Linear. This is the simplest form of interpolation; it draws a straight 
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line between the two points to be interpolated. This is less computa- 
tionally expensive than Quadratic or LaGrange3 (below). 


‘Linear wrap around’ is a new selection. 


multitable (n) This selects the MultiTable to be used by the hammer. 
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The Junction block is used to connect elements in a physical modelling 
system. 


The Junction can be grown in a single dimension, “input.” This will add 
additional input, output, and admittance ports. 


Use any name you choose. 
Min value: 0.0 Max value: +1.0 


This sets the admittance for the junction itself. A value of 0.0 means that 
the junction has an infinite impedance, reflecting signals with a -1; a set- 
ting of 1.0 has no effect. 


Min value: -1.0 Max value: +1.0 
These are the default values for the input and output(n) audio ports. 
Min value: 0.0 Max value: +1.0 


This sets the admittance for input and output ports (n). The admittance 
may be thought of as the cross-sectional area of the cylinder; the greater 
this value is, the more the cylinder interacts with the junction and the 
other cylinders connected to the junction. 


Junction Equations 


For those who are interested, the following are the equations for the 
Junction block. P; is the total pressure in the Junction; Pin, is the input 
pressure for input i; Pout; is the output pressure for output i; T’, is the 
admittance of input and output ports i; 0, is the weighting factor for the 
pressure of input i, and 04 is the weighting factor for the junction itself. 


N 


P,= 0, Pin, 
i=l 


Pout, = P,— Pin, 
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output weight 


addin length (n) 


addin variable (n) 


pressure length (n) 


Ladder 


The ladder is a series of two-port junctions alternating with single- 
sample delays. This, like the Lattice block, can be used for vocal mod- 
els, or for bore simulations (conical bores, mouthpieces, etc.). 


The Ladder block can be grown in three separate dimensions: addin 
length, pressure length, and reflection. Growing addin length creates 
additional addin length and addin variable input ports; growing pres- 
sure length creates additional pressure length input and pressure vari- 
able output ports. Growing reflections creates additional reflection, 
weight, and addin fixed input ports, and pressure fixed output ports 
(each set of these represents a stage in the filter). 


The Control Panel Meter’s “Size” type can be used for a graphic display 
of the Ladder block’s segments. 


Use any name you choose. 
Min value: -1.0 Max value: +1.0 


These are the default values for the input audio ports. 


Min value: -1.0 Max value: +1.0 


These are the default values for the output audio ports. 


Min value: -1.0 Max value: +1.0 


This is the summed output of all of the stages’ individual outputs (each 
stage’s gain into this output is determined by its weight parameter). 
There is a new port right here called ‘current spacing’. This 
lets the spacing of the ladder be SELECTED at runtime 
between 1 and the maximum determined by the setting of 
the ‘maximum spacing’ constant below. For ‘current spac- 
ing, the value must be adjusted up by 1. e.g. if you want a 
spacing of 2, send 3 here, etc. 


Enumerated port. Use a selector to change. Use for vocal, 
for instance. 


Min value: 0.0 Max value: +1.0 


This is an arbitrary number, such that 1.0 is equal to the total length of 
the Ladder. It determines the stage of the Ladder which is fed by addin 
variable (n). Eventually, this will be modulatable in real time. 


Min value: -1.0 Max value: +1.0 
This is the input to addin (n). 
Min value: 0.0 Max value: +1.0 


This is an arbitrary number, such that 1.0 is equal to the total length of 
the Ladder. It determines the position of pressure variable (n). Use this 
to make a tap out from a specific stage of the filter. Eventually, this will 
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be modulatable in real time. 

Min value: -1.0 Max value: +1.0 

This is the output of pressure (n). 

Min value: -1.0 Max value: +1.0 

This is the reflection of junction (n). 

Min value: -1.0 Max value: +1.0 

The volume of stage (n) at the weight output. 
Min value: -1.0 Max value: +1.0 


This is the addin for stage (n). 


Min value: -1.0 Max value: +1.0 


This is the output for stage (n). 


Interpolation improves the quality of the audio. There are several basic 
types of interpolation, each of which can be performed entirely on the 
dsp or with the assistance of the host. Using host-assisted interpolation 
frees up some dsp code space. 


This is the interpolation for the addin. 
None. No interpolation. 


None Host. No interpolation, but the host helps out by calculating off- 
set. 


Linear. This uses simple straight-line interpolation. 


Linear Host. Similar to Linear above, but the host calculates offsets and 
interpolation parameters. 


This is the interpolation for the pressure. 
None. No interpolation. 


None Host. No interpolation, but the host helps out by calculating off- 
set. 


Linear. This uses simple straight-line interpolation. Linear interpolation 
is less computationally expensive than Allpass or LaGrange3 (below). 


Linear Host. Similar to Linear above, but the host calculates offsets and 
interpolation parameters. This is less computationally expensive than 
Allpass or LaGrange3 (below). 


Allpass. This option uses a constant table to provide high-quality all- 
pass filtering. It is somewhat more computation-intensive than Linear 
(above), but provides a flat frequency response. 


Allpass Host. This is the same as Allpass above, except that offsets and 
interpolation parameters are calculated on the host. 


LaGrange 3. This interpolation method uses three points for the inter- 
polation. The frequency response is better than linear, but still not per- 
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fect. This is the most computationally expensive interpolation method. 


LaGrange 3 Host. Same as LaGrange 3 above, except that the coeffi- 
cients are calculated on the host. 


The four new entries associated with delay interpolation 
tables follow here. 


There is a new constant field at the end ‘maximum spacing’. 
This determines the maximum number of delays between 
junctions in the ladder. This allows you to allocate the cor- 
rect amount of memory. 
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The Lag block is a simple one-pole lowpass filter which has 2 separate 
cutoff frequencies. The attack frequency is used when the input level to 
the Lag is rising, and the decay frequency is used when the input is 
diminishing. 

Due to the low sampling rate of MIDI controllers, it is often desirable to 
filter them before use in SynthKit. Filtering, however, has the drawback 
of introducing delays, which can sometimes cause difficulties - espe- 
cially with breath control, which can be responsible for shaping the 
attack of a sound. If the controller is delayed by the filter, the attack 
may not be fast enough. The Lag block helps to alleviate this problem. 
Setting a high attack frequency and a low decay frequency allows fast 
response to a quick burst of data, while smoothing the less time-sensi- 
tive decay portions. 


The Lag block may also be used as a simple envelope generator, con- 
trolled by either a trigger or a gate. 


Name the block as you wish. 

Min value: -1.0 Max value: +1.0 

These are the default values for the input and output ports. 
Min value: 0.0 Max value: 1.0 

This is the cutoff frequency for the attack. 

Min value: 0.0 Max value: 1.0 

This is the cutoff frequency for the decay. 


This selects the type of lag filter to be used. 


Normal. A simple one-pole lowpass filter. This lag type can be either 
host or dsp. 


Smoothing Rate. The name is short for “smoothing constant rate.” 
Some users may be familiar with this option in regards to portamento; 
basically, the filter progresses between points at a constant rate, regard- 
less of the distance between the points. Depending how large that dis- 
tance is, the filter will take more or less time to move to the new point. 
The smoothing filters are primarily for use with controller data, and 
work on the host only. 


Smoothing Time. The name is short for “smoothing constant time.” 
Again, some users may be familiar with the term “constant time” in 
regards to portamento; in this case, the filter progresses between points 
at a constant time, regardless of the distance between the points. This 
means that if there is a large difference between the two points, the 
steps may be coarser. The smoothing filters are primarily for use with 
controller data, and work on the host only. 
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There are two new menus for lag. 

‘reset on restart’ has the choices ‘False’ and ‘True’ 
ANDY SAYS: DON’T KNOW, ASK DAVE 
Charlie says this is vestigial - does it still work? 


‘precision’ has the choices ‘Single Precision’ and ‘Double 
Precision’. (Lag is basically a lowpass filter, with one coeffi- 
cient for up and another for down) As with other enve- 
lopes, doule precision is only necessary for very, very long 
times, in order to ensure that it actually gets to the value. 
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The Lattice Block is a filter made out of series of Junction modules and 
cylinders, each only a single sample long. It is particularly useful in 
vocal models. The Lattice block offers a single parameter, named reflec- 
tion, to control the ratio between the admittances of its segments. 


The Lattice is similar to the Ladder, but uses delays in only one direc- 
tion. The Ladder is more physically correct for vocal and bore models, 
but the Lattice is cheaper and more efficient...and can yield the same 
results. 


You can grow the Lattice block ina single dimension, “reflection,” 
which creates additional reflection and weight ports. 


The Control Panel Meter’s “Size” type can be used for a graphic display 
of the Lattice block’s segments. 


“You can call me anything you like, but my name is Veronica.” - 
McManus & McCartney 


Min value: -1.0 Max value: +1.0 
These are the default values for the input audio ports. 
Min value: -1.0 Max value: +1.0 


These are the default values for the output audio ports. 


Min value: -1.0 Max value: +1.0 


This is the summed output of all of the stages’ individual outputs (each 
stage’s gain into this output is determined by its weight parameter). 


Min value: -1.0 Max value: +1.0 


This sets the ratios of the two admittances for segment (n) of the Lattice 
filter. At 0.0, the two admittances are identical; at +1.0, it is as if the left 
admittance (input/output 1) were 0 and the right admittance (input / 
output 2) infinite; and at -1.0, itis as if the left admittance (input/output 
1) were infinite and the right admittance (input/output 2) equal to 0. 


The admittance may be thought of as the width of the cylinder; the 
greater this value is, the more the cylinder interacts with the junction 
and the other cylinders connected to the junction. 


Min value: -1.0 Max value: +1.0 


The volume of stage (n) at the weight output. 


Min value: 1.0 Max value: (infinite) 


This sets the number of delays between junctions, allowing you to con- 
trol the spacing of the lattice sections. 
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Math 


The Math block allows the user to process one or more signals through 
an equation. 


Many of the math functions in the Math block are available on both the 
Host and the DSP; others are available only on the Host, and some only 
in table generation, as noted below. 


The Math block can be grown in two dimensions, “input” and “out- 
put.” Growing inputs adds more inputs; growing outputs creates an 
additional output and another equation. 


Note that, for host funtions only, the Optimized Math block (see page 
169) provides optimized versions of specific common functions, which 
will be more efficient than performing the same function in the Math 
block. The Optimized Math block is not as flexible as the Math block, 
however - and most importantly, it runs only on the host, not on the 
DSP. 


Call it anything that you like. 
Min value: -1.0 Max value: +1.0 


These are the default values for the variable number of input ports (let- 
tered A-Z). 


Min value: -1.0 Max value: +1.0 


These are the default values for the variable number of output ports 
(lettered A-Z). 


The math block supports a large number of building blocks for equa- 
tions, as listed below. Capital letters (A, B, C etc.) refer to the data at the 
input ports; adding an @ refers to the output ports instead, so that @A 
means the data at output port (A). You may use constants and paren- 
theses, and spaces are always ignored. 


Be sure not to refer to the output of a line at or below the current line. 
For example, do not refer to @C from line A,B or C. 


Also, parenthesis cannot be nested. As a workaround, complicated 
compound expressions can be broken into multiple lines, and then ref- 
erenced using the @ notation. 


You may grow additional equations by adding outputs (one per out- 
put). 

When putting together an equation, remember to pay attention to the 
precedence of arithmetric operators. In particular, note that SynthKit 
executes divides before multiplies. You can always override the default 
precedence using parentheses. 


The functions min, max, ave, and mse support variable numbers of 
parameters. 
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You must format the equation to match the port type (continuous or 
enumerated). 


Specify enumerated numbers by omitting the decimal point. For 
instance, enumerated 1 is simply 1. You may also use the hex prefix ($) 
if you like. 


Specify continuous numbers by using the decimal point. For instance, 
continuous 1 is 1.0. 


On the DSP, all continuous numbers must be between -1.0 and +1.0, 
inclusive; on the Host, the range is from -8.0 to +8.0. 


+ (addition). Adds two values. 


— (subtraction or unary minus). What the heck, you might ask, is a 
“unary minus?” And don’t they have antibiotics for that kind of thing, 
nowadays? Well, no actually; that just means “negative number sym- 
bol,” for making a “-2” for instance. 


* (multiply). Note that the shift left function efficiently performs multi- 
plication by factors of 2. 


A divide function is available on the Host only (see below). Note also 
that the shift right function efficiently performs division by factors of 2. 


clip. This sets a maximum amplitude for the input, after which it will 
be clipped. Clip takes 2 arguments, as in clip(A,b); A is the input value, 
and b the amplitude, so that A is clipped at -b and +b, as shown below. 
You can also think of b as the maximum excursion from zero. 


clip(A,b) 


clippos (clip positive). This clips all negative values to 0 (positive val- 
ues are left untouched). 
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clipneg (clip negative). This clips all positive signals to 0 (negative val- 
ues are left untouched). 


max (maximum). Returns the highest of its inputs. This function may 
have a variable number of arguments (up to 4 on the dsp, and unlim- 
ited on the host). 


min (minimum). Returns the lowest of its inputs. This function may 
have a variable number of arguments (up to 4 on the dsp, and unlim- 
ited on the host). 


squ (square). The square of the argument (A*A). 


abs (absolute value). Put simply, makes all numbers positive, whether 
they are or not (hmmmm... I wish I had something like that for my 
bank account). Negative numbers are made positive; positive numbers 
are unaffected. 


sign. “Signum” function. Also known as a hard limiter. Outputs a 
“+1.0” for positive input, and a “—1.0” for negative input. 


The following functions send out “0.0” for 0/false, and “+1.0” for 1/ 
true. For logical input, less than or equal to zero is considered to be 
false, and greater than zero is considered to be true. They are used for 
conditional equations. 


> (greater than). A>B is true if A is more than B. 


>= (greater than or equal to). A>=B is true if A is either equal to B, or 
more than B. 


< (less than). A<B is true if A is less than B. 


<= (less than or equal to). A>=B is true if A is either equal to B, or less 
than B. 


== (equal to). A=B is true only if A is exactly equal to B. 
!= (not equal to). A!=B is true unless A is equal to B. 


| | (logical or). If either of the arguments is positive (greater than zero), 
this function is true. 


A% (logical exclusive or). If one, but not both, of the arguments is posi- 
tive (greater than zero), this will send out a “1” (true). 


! (logical not). This can be applied to a logical operation to send out the 
opposite of its evaluation, so that true becomes false and false becomes 
true (sounds kind of biblical, doesn’t it?). For instance, if A=0.5, then the 
expression !(A>0.6) is evaluated as follows. First, it is determined that 
(A>0.6) is false; that result is then inverted by the logical not, so that the 
false becomes a true, and “+1” is sent out. (Wayne says: Not. Hway!) 
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The bitwise functions operate on the individual bits of the digital sig- 
nal, as opposed to the signal in its entirety. While the bitwise and, or, 
and not functions are somewhat esoteric, the shift left and shift right 
provide easy and computationally efficient ways to multiply and 
divide by powers of 2. 


<< (shift left). This shifts the bits of the left argument to the left, by the 
number of bits specified by the right argument. Effectively, this multi- 

plies the signal by factors of 2. Shift left is much more computationally 
efficient than using the multiply operator. An example would be A>>1. 


>> (shift right). This shifts the bits of the left argument to the right, by 
the number of bits specified by the right argument. Effectively, this 
divides the signal by factors of 2. Shift right is much more computation- 
ally efficient than using the divide operator - and can be performed on 
the DSP, while an actual divide cannot. 


& (bitwise and). This takes two inputs, and operates on a bit-by-bit 
basis within each byte. If bit 1 is set to 1 for both of the compared bytes, 
then bit 1 will be set to 1 in the output; otherwise, if either one is set to 1 
and the other 0, or both are set to 0, it will be set to 0. See the diagram 
below. 


| (bitwise or). This takes two inputs as well, and like the bitwise and 
above, operates on each bit separately. Each bit in which either byte has 
a 1 is set to 1 in the output; only bits in which both bytes have 0 are set 
to 0 in the output. See the diagram below. 


Bitwise And & Or Diagram 


| 101000! LOS Bitwise And 


Inputs: 


CIMCON. Sxenanigisi: atdeese 


!! (bitwise not). This takes only a single input. Like the other bitwise 
operations, it operates on each bit separately. The bitwise not simply 
inverts the bits of the input, changing all 1’s to 0’s, and all 0’s to 1’s. 


These functions are available only on the DSP, and not on the host. 
uadd (unsigned add). 2 arguments. 


usub (unsigned subtract). 2 arguments. 
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Imult (low multiply). 2 arguments. Low multiply acts as the usual mul- 
tiply, but takes its result from the low 24 bits of the 48 bit result. 
Imult(x,y) is thus (x*y)<<24. If used properly, you can do multiplies of 
greater than one in real time. The only trick is that y should be a very 
small number, and both x and y should be positive only. Although y is 
small, its resolution will not be very good, since it still must be a 24 bit 
number. 


Notice that x = Imult(x,1.0/16777216.0). Thus, x times y (where y is 
greater than one) is lmult(x,y /16777216.0). For y=4.0, 4.0/1677216.0 = 
0.0000023849045, so you would use Imult(x,0.0000023849045). 


diff. This returns the difference in level between the current value and 
the value one sample previous. 


diffpos. This is the same as diff, but clips the result to a positive value 
(all negative values are clipped to 0). 


diffneg. This is the same as diff, but clips the result to a negative value 
(all positive values are clipped to 0). 


octup. An octave-liberation organization. No, just kidding. This is an 
octave up function: octup(A) = (A*A-0.5)<<1. This is used for doubling 
the frequency of an audio signal. Also known as a 2nd order Chebyshev 
polynomial. 


These functions are available only on the host, and not on the DSP. 
/ (divide). See also the shift right function. 
mod (modulus). 2 arguments 


This function divides the first argument by the second, and then sends 
out the remainder. If x=11 and y=3, for instance, mod(x,y) = 2. 


This function works only on the host, and not on the DSP. 


mse (mean squared error). This function measures the spread of its 
arguments by computing the sample standard deviation. Mean squared 
error may have a variable number of arguments. 


This function works only on the host, and not on the DSP. 


ave (average). The ave function takes the average of its arguments; for 
instance, ave(7, 9, 8) = 8. Average may have a variable number of argu- 
ments. 


A+0.5 
(A-B)*0.3 
squ(A)+0.3*A+0.1 
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min(A,B,0.1) 


Conditional executions of the form “if x is true, return y; otherwise, 
return z” are also supported. The syntax is just like in the C program- 
ming language, so that the above condition becomes x?y:z. Some exam- 
ples are: 


(A>0.1)?A:B 
(abs(A)>abs(B))?0.2:B*0.4 
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display the level of a signal M ete ir 


The Meter block can be used to display the level of a SynthKit signal. 
m This is a Control Panel block, similar to the Slider and Selector. The 
block itself doesn’t do anything, but it causes a bar-graph style meter to 
appear in the Control Panel window. This bar-graph shows the level of 
input to the Meter block, updated 6 times per second. You can use this 
to determine the overall level at a certain point in the patch, or to moni- 
tor clipping. 
The Control Panel window (described on page 50) allows you to adjust 
the appearance of meters. 


name Name this anything you like. This name will appear along with the 
meter in the control panel. 


input Min value: -1.0 Max value: +1.0 


The level of this input is graphically displayed in the Control Panel 
meter. 
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Ports 


name 


input (n) 


output 


amplitude(n) 


mix two or more 
signals together 


The Mixer block allows you to mix two or more signals together, with 
individual control over each one’s amplitude. 


The Mixer may be grown ina single dimension, “inputs,” which creates 
additional input and amplitude ports. 


For a cheaper two-into-one mixer, see the Pan block on page 174. 


Name this block as you please (Tom, perhaps’). 
Min value: -1.0 Max value: +1.0 


These are the inputs to the mixer. Input (n)’s gain is scaled by the ampli- 
tude port of the same number. 


Min value: -1.0 Max value: +1.0 


This is the summed mix of all the inputs. 


Min value: -1.0 Max value: +1.0 


This is the gain value for input (n). 


Note: If the amplitude of a port is 1.0 and the port is not connected, the 
DSP code is optimized to eliminate the multiplies, resulting in tighter 
code. 
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leakage 


width 


low 


high 


band 


Dass 


Dass 


Dass 


Multi Filter 


The Multi Filter block is a state-variable filter which efficiently splits its 
output into highpass, lowpass, and bandpass. 


Your name here. 

Min value: -1.0 Max value: +1.0 

This is the input to the filter. 

Min value: 0.0 Hz Max value: 24000.0 Hz (1/2 sample rate) 
This sets the cutoff frequency of the filter. 


When formatted in Float (as opposed to the default Pitch Herz), avalue 
of 1 is equal to the Nyquist frequency of the current DSP sampling rate, 
as set under Parameters in the DSP menu. This means that if you 
change the DSP sampling rate, you may need to alter your cutoff fre- 
quency as well. 


If you wish to modulate the filter with note number, remember to run 
the note data through an exponential table. 


Min value: 0.0 Max value: +1.0 
Leakage is set to 1.0 by default. 
Leakages just below 1.0 will reduce the sharpness of reso- 


nances at lower cutoff frequencies. Much lower, and the fil- 
ter will be dramatically altered. 


Min value: 0.0 Max value: 1.0 
The smaller the filter width, the greater the resonance. 
Min value: -1.0 Max value: +1.0 


This port sends out a lowpass filtered version of the input. 


Min value: -1.0 Max value: +1.0 


This port sends out a highpass filtered version of the input. 


Min value: -1.0 Max value: +1.0 


This port sends out a bandpass filtered version of the input. 
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The Multi Mode block is a filter which allows you to simultaneously 
2 tap its four different filter outputs. These filters will sound different 
than the corresponding cascade filters. 


In addition to use as multimode, resonant filters for analog and other 
subtractive algorithms, these filters may be excited by a source, such as 
a hammer, as if they were resonating bodies. They are essentially mod- 
els of a damped spring. The cutoff frequency controls the pitch, and the 
width controls the decay time (in addition to focusing the pitch). 


The Multi Mode block cannot be grown. 


Ports 
name Your name here. 
input Min value: -1.0 Max value: +1.0 
This is the input to the filter. 
output lowpass Min value: -1.0 Max value: +1.0 
This port sends out a lowpass filtered version of the input. 
output bandpass Min value: -1.0 Max value: +1.0 
This port sends out a bandpass filtered version of the input. 
output bandstop Min value: -1.0 Max value: +1.0 
This port sends out a bandstop filtered version of the input. 
output highpass Min value: -1.0 Max value: +1.0 
This port sends out a highpass filtered version of the input. 
cutoff Min value: 0.0 Hz Max value: 24000.0 Hz (1/2 sample rate) 


This sets the cutoff frequency of the filter. 


When formatted in Float (as opposed to the default Pitch Herz), avalue 
of 1 is equal to the Nyquist frequency of the current DSP sampling rate, 
as set under Parameters in the DSP menu. This means that if you 
change the DSP sampling rate, you may need to alter your cutoff fre- 
quency as well. 


If you wish to modulate the filter with note number, remember to run 
the note data through an exponential table. 


width Min value: 0.0 Max value: 1.0 


The smaller the filter width, the greater the resonance. 


Menus 


type This menu sets the type of filter to be used. 


Constant Q. If you change the cutoff, the width of the filter remains 
constant. 


Constant Ring Time. As the cutoff is changed, the decay of the filter 
remains the same. Unlike the constant q version, the width parameter 
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must be close to 1.0 to resonate. 


Multi Mode 
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generate white noise 


The Noise block generates white noise, for use in percussive sounds, 
adding noise to physical models, or injecting randomness into any 
algorithm. 


Give this block any name you please. 
Min value: -1.0 Max value: +1.0 


Gee, that output sure sounds noisy, doesn’t it? (Oh...never mind!) 


This menu allows you to select the method of noise generation. 
Additive. This is the recommended selection. 

Additive Filtered. This adds a fixed zero filter (2-tap averaging). 
Shift 17. This is an alternate noise generation method. 

Shift 23. This is another alternate noise generation method. 


Macintosh. This option is available for the Macintosh host only. 
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specific mathematic functions © ] pt i m IZ ed M at h 


The Optimized Math block includes optimized versions of a selection 
oe of common functions, as listed below, for use on the host CPU (not the 
DSP). The block is fixed to support two inputs and one output. Perfor- 


mance for these functions is improved in comparison to the general- 
purpose Math block. 


Optimized math block functions include the following: 
A+B. 

A-B. 

A*B. 

A/B. 
A<<B. 
A>>B. 
uadd(A,B). 
min(A,B). 
max(A,B). 
abs(A). 
A>B?C:D. 
A>=B?C:D. 
A#B?C:D. 
clippos(A). 
clipneg(A). 
sign(A). 


For details, see the descriptions of these functions for the Math block. 
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Ports 


name 


reset 


phase (n) 


output (n) 


frequency 


symmetry 


generate a 
complex waveform 


This version of the Oscillator block generates its waveforms without 
using a table. You can use it to generate either audio waveforms or 
LFO’s (remember the minimoog?). 


This oscillator is not band-limited, which unfortunately may result in 
aliasing noise. For the highest audio quality, use the Audio Oscillator 
instead. 


Additional output ports can be grown; for each output, an additional 
phase port is also added. 


Name this block as you please. 
Min value: 0 Max value: too 


When a trigger is received at the reset port, the oscillator’s phase is 
reset. 


Note that Grunge() can be used to affect the initial phase. 
Grunge randomizes the intitial phase of the oscillator, as 


happens in analog synths. reset will set to specified phase 
regardless of grunge on/off. 


phase goes from -1.0 to 1.0 now. It ia scaled by a factor of 4. 
So you run through an entire period in 0.5 units. 


For example, -180 degrees to +180 degrees is equivalent to a 
range of -0.25 to +0.25. 


ANDY WILL CHECK TO SEE IP THIS TS CORRECT. 


Min value: -1.0 Max value: 1.0 


This controls the phase of output (n). Using another oscillator as the 
phase modulation source produces FM. To allow deeper modulation 
for those synthesis techniques, the input is scaled by a factor of 4. 


Min value: -1.0 Max value: +1.0 


This is audio output (n) of the oscillator. Outputs are grown in conjunc- 
tion with phase ports. 


Min value: 0.0 Hz Max value: 24000.0 Hz (1/2 sample rate) 


This sets the frequency of the oscillator. Its input should be Note, pro- 
cessed through the cExponentialNote table. 


Min value: 0.0 Max value: +1.0 


This specifies the width of a pulse wave, or the symmetry of a triangle 
waveform. 


So, what is symmetry for a triangle wave>? At 0, the triangle is a stan- 
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Menus 


oscillator 


Oscillator 


dard triangle wave. As the value increases, a portion of the waveform 
will be kept at 0, and then jump up to the normal triangle wave value. 


This allows you to select the waveform for the oscillator. 

Sawtooth. Standard sawtooth waveform. 

Pulse. Use either as a pulse or, with symmetry of 0.5, as a square wave. 
Triangle. Standard triangle waveform. 


Sine. Sine oscillator - try using the x * (1.0 - abs(x)) oscillator, below, 
instead. The phase input will not work when this option is selected. 


Impulse. A simple one-sample impulse. 


x * (1.0 - abs(x)). This is an approximation of a sine wave. It is preferable 
to the Sine oscillator, above, because, as Mr. O’Connell says, “The fre- 
quency on that one is even more wacked.” 


x - x*x"x. This is a second sine approximation, not as good for most pur- 
poses as the first. 


There is now a ‘mode’ menu. The choices are ‘Normal’ and 
‘Low Frequency’. ‘Low Frequency’ shifts the frequency 
input down by 8 bits (a factor of 256), for increased resolu- 
tion at very low frequencies. 
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Oscillator Table using a table 


You can use the Oscillator Table block to generate either audio wave- 
forms or LFO’s (remember the minimoog?). The waveform is derived 
from a multitable. Note that the Oscillator block, described on page 169, 
does not require tables. 


You can grow additional multitables for this block. 


Any name you like; any name at all. You can call it Flower, if you want 
to. 


When a trigger is received at the reset port, the oscillator’s phase is 
reset. 


phase now goes from -1 to 1. Same comments as phase in 
the oscillator block. 
Min value: 0.0 Max value: 1.0 


This controls the phase of the oscillator. Using another oscillator as the 
phase modulation source produces FM. To allow deeper modulation 
for those synthesis techniques, the input is scaled by a factor of 4. 


Min value: -1.0 Max value: +1.0 
This is the default value for the audio output port. 
Min value: 0.0 Hz Max value: 24000.0 Hz (1/2 sample rate) 


This sets the frequency of the oscillator. Its input should be Note, pro- 
cessed through the cExponentialNote table. 


Min value: -1.0 Max value: +1.0 


This has no effect on the oscillator output per se. It sends out the level 
amount programmed for the selected table in the multitable, and is 
intended to feed a mixer block. This is similar to the level port in the 
Sample block. 


Min value:0 Max value: +ce° 


The Oscillator Table block can only actually use a single multitable at a 
time. However, you can use the grow command to add more multita- 
bles, which appear as multitable 1, multitable 2, etc.; this parameter 
then allows you to select between them. 


Multitables cannot be selected in real time on the Macintosh host. How- 
ever, you can use the position port (below) in real time to select 
between the tables contained in a multitable. 


Min value: 0.0 Max value: +1.0 


This selects the table to be used from the current multitable (based on 
key position, for instance). 
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using a table Oscillator Table 


Menus 


interpolate Interpolation improves the smoothness of the table, and thus also the 
quality of the audio. 


None. No interpolation. 


Linear. This is the simplest form of interpolation; it draws a straight 
line between the two points to be interpolated. This is less computa- 
tionally expensive than Quadratic or LaGrange3 (below). 


New selection: ‘Linear wrap around’ 


There is now a ‘mode’ menu between interpolate and mul- 
titable. The choices are ‘Normal’ and ‘Low Frequency’. 


multitable This selects the multitable to be used by the hammer. 
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Ports 


name 


input (n) 


output (n) 


pan (n) 


control the stereo placement 
of one or two signals 


The Pan block enables you to control the spread of one or two inputs 

over the stereo field. It can also be used as an economical two-into-one 
mixer with a single balance control; this is cheaper than using the mix 

block. Pan may be dynamically modulated. 


You can independently grow inputs, outputs, and pan inputs. This 
block is pretty flexible, and its functionality depends upon the configu- 
ration of these ports. 


Currently, there are three useful configurations. One input, one pan, 
and two outputs allows you to pan a single signal over two outputs. 
Two inputs, one pan, and one output creates an inexpensive two-to-one 
mixer, with the pan input providing a balance control between the two 
inputs; this is more efficient than using the mix block. Two inputs, one 
pan, and two outputs gives you cross-panning of the inputs, as shown 
in the diagram below. 


Try any name you like. Peter, for instance - or maybe just something 
“satyrical” from Greek mythology. 


Min value: -1.0 Max value: +1.0 


This is the default value of input (n). 


Min value: -1.0 Max value: +1.0 
This is the default value of output (n). 
Min value: 0.0 Max value: 1.0 


This determines the panning of the inputs. 


In the case of the two input, two output configuration, a value of 0.5 
will send equal amounts of both inputs to each output; a value of 0.0 
results in hard panning with input 1 to the right and input 2 to the left; 
and a value of 1.0 results in hard panning with input 1 to the left and 
input 2 to the right. Intermediate values produce soft panning. 


In the case of the two input, one output configuration, the equation is: 


output =(pan*input1)+((1-pan)*input2) 
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Pan Block Diagram - 2 inputs, 2 outputs 
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Patch 


set the performance 
parameters of an algorithm 


SynthKit’s performance settings - such as number of voices, MIDI key 
and velocity ranges, voice allocation, MIDI channel, and so on - are con- 
trolled by the Patch block. 


When To Use A Patch Block 


Certain algorithms have common functions applied to multiple voices, 
such as a piano with multiple strings (duplicated for every new voice) 
and a single soundboard (allocated only once, regardless of the number 
of voices sounding). The string would be placed within one, dynami- 
cally allocated Patch block; the soundboard would be placed in a sec- 
ond Patch block, with fixed allocation. 


mention the OASYS allows only Audio Input, Audio Out- 
put and Patch blocks in the root algorithm. 


Patches - There must only be one audio output. 


The connection output block connected to this audio out- 
put have 2 fields that must be set correctly: 'kind' should 
be set to "Dynamic Summation’ 


'ramp' should be in use and set to an appropriate value. 
Both of these are the defaults for the connection output 
block. 


The top level patch block/s should have their 'type' field/s 
set as desired. Usually 'dynamic’, but static is a valid choice 
if there is to always only be 1 copy for all voices. 


Effects - There will always be two audio inputs and two 
audio outputs. 


The connection output blocks should have ‘kind’ set to 
‘Direct, 

‘Ramp’ should not be used (the little check box under the 
wrench should be clicked off). 


All the effects should have their 'type' field in the top 
level patch block set to 'static’. 


For both patches and effects, setting the 'voices' field of any 
patch block to other than 1 will cause the OASYS compiler 
to complain. 
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Ports 


name 


Menus 


allocation 


Patch 


Other Groovy Patch Block Facts 


Double-clicking on this block opens up the Algorithm edit window for 
the patch; command-clicking opens up the normal Block window. 


It doesn’t make sense to nest Patch blocks - that is, for one Patch to con- 
tain another Patch. SynthKit will produce errors on compiling if you 
have tried to do this. 


If the option and control keys are held down when adding an Algo- 
rithm or Patch block, you can import an algorithm from another Synth- 
Kit file. 

The items within the patch block are replicated for each voice, as set by 
the number of voices parameter. 


Limitation: SynthKit always places each patch on a separate 
DSP to run.Number of voices comes from the program in 
OASYS engine, not here. For running in SynthKit, the num- 
ber of voices in the patch must always be set to 1 or the 
OASYS police complain. 


The entire voice of a patch must fit within a single dsp, but multiple 
voices of the same patch may be placed in different dsps. The Execution 
window’s dsp allocate parameter specifies whether the system will try 
to pack additional voices into the current dsp, or always use the next 
dsp. 


Name the block as you please. “A block by any other name would smell 
as sweet” - but you still might want to name it something vaguely 
descriptive. 


Cycle. This is the default allocation mode, in which each available voice 
is used in turn. If the same key is struck and then re-struck, both notes 
will sound through their release. Cycle always looks for the oldest inac- 
tive voice. 


Retrigger. This allocation mode is slightly more efficient than Cycle. 
Instead of taking the time to search for the oldest inactive voice, it sim- 
ply uses the first one that it finds. Generally, you shouldn’t need to use 
Retrigger. 


Reuse. In this mode, if the same key is struck and then re-struck, the old 
note will be stolen by the new. Otherwise, this mode is identical to 
Cycle, described above. 


Legato Allocation 


These three options cause the voice to use monophonic voice allocation, 
so that only one note sounds at a time. Additionally, if a note is played 
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Patch 


port 


channel 


type 


io ramp 
level ramp 
audio input 


audio output 


Constants 


set the performance 
parameters of an algorithm 


legato - that is, if it is pressed down before a previously sounding note 
is released - the pitch of the note will change, but it will not be re-trig- 
gered. This method is good for simulating monophonic instruments, 
such as winds, or lead sounds. Multiple note presses are remembered 
so that when a key is released, the proper note to play is recalculated. 
The three options differ only in the matter of voice prioritization. 


Legato Last Note. Last-note priority - the most recent note is always 
played. This is usually the best choice of the three. 


Legato Low Note. The lowest note held down will be played. 
Legato High Note.The highest note held down will be played. 


Since we are using OMS now, port is ignored. 


This is intended to set the port used for MIDI reception, but it is not 
implemented. Currently, the Macintosh MIDI Manager must be used, 
and SynthKit will automatically hook up to the Modem port. 


Omni. The Patch will respond to all MIDI channels on the selected port. 


1-16. This will put the Patch into Poly mode on the selected channel 
number. It will thus respond to MIDI data only on the selected channel 
of the selected port. 


This parameter is for support of different patch types on target systems, 
such as OASYS PCI. 


Fixed. The patch will be allocated whether or not there are voices 
sounding. This is not used for OASYS PCI. 


Static. There will only be one instance of the patch, regardless of the 
number of voices sounding. This is intended for use with global effects 
within synth algorithms (such as a static formant filter coupled with 
dynamic glottal oscillators), or for effects algorithms. Use this for 
OASYS PCI effects algorithms. 


Dynamic. The patch will be allocated for each voice. Use this for 
OASYS PCI synth patches. 


This parameter is not implemented for use with OASYS PCI. 
This parameter is not implemented for use with OASYS PCI. 
This parameter is not implemented for use with OASYS PCI. 
This parameter is not implemented for use with OASYS PCI. 


A number of parameters in the Patch - including number of voices, 
amplitude, note low and high, velocity low and high, and pitchbend 
amount - do not have any direct effect on the algorithm. Instead, they 
determine the values of the system sends of the same names, to be 
received where desired in the algorithm. What these parameters mean 
depends entirely on how the algorithm designer places and connects 
the system receives. 
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set the performance 
parameters of an algorithm 


number of voices 


amplitude 


transpose 


fine 


note low 


note high 


velocity low 


velocity high 


pitchbend amount 


monitor 


status | 


status 2 


Patch 


Most of these parameters will be passed on to the Performance or Pro- 
gram-level parameters of target systems. 


Again, OASYS requires number of voices to be 1 at compile 
time. 
Min value:0 Max value: 8 


This sets the value of the Number of Voices System Send, intended to 
control the maximum number of voices which the patch can simulta- 
neously sound. The maximum possible number of voices will change 
relative to the complexity of the patch. This value must be an integer. 


Min value: 0.0 Max value: +1.0 


This controls the value of the Amplitude System Send, intended to be 
the overall volume level of the Patch. 


Min value: -1.0 Max value: +1.0 


This sets the number of steps by which the voice will be transposed; the 
value is included in the System Receive, Note. 


Min value: 0.0 Max value: +1.0 


This is the fine tuning for the Patch; as with transpose above, this is 
included in the value of the Note System Receive. 


Min value:0 Max value: 127 


This controls the value of the System Send Note Low, intended to set 
the lowest MIDI key number on which the voice will sound. 


Min value:0 Max value:127 


This sets the value for the System Send Note High, which is meant to 
control the lowest MIDI key number on which the voice will sound. 


Min value: 1 Max value: 127 


This controls the value of the System Send Velocity Low, intended to 
set the lowest MIDI velocity level on which the voice will sound. 


Min value: 1 Max value: 127 


This sets the value for the System Send Velocity High, which is meant 
to control the highest MIDI velocity level on which the voice will 
sound. 


Min value: 0.0 Max value: 1.0 


This controls the value of the System Send Pitchbend Amount, 
intended to set the pitch bend sensitivity of the Patch. 


Min value:0 Max value: current number of voices 


If this worked...it would determine which voice is listened to by control 
panel display items (such as meters). 


This is a dsp-specific parameter, which none of us need to know about 
for now, thank goodness. 


This is another dsp-specific parameter. 
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Patch parameters of an algorithm 
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change the pitch of a signal PitchShifter 


signal. This may be used for thick, stable chorusing effects, or for more 
radical transposition. 


The Pitch Shifter block allows you to (what else?) shift the pitch of a 
b 


Ports 
name Enter any name you like. 
input Min value: -1.0 Max value: +1.0 
These are the default values for the input and output ports. 
outputLeft, outputRight Min value: -1.0 Max value: +1.0 
These are the default values for the input and output ports. The two 
outputs are phase-inverted, to create a stereo effect. 
pitch Min value: -1.0 Max value: +1.0 
This sets the amount of pitch alteration. -1 is equal to an octave down, 0 
causes no pitch shifting, and +1 is equal to a fifth up. This will interact 
with the delay amount, as set below. 
mix Min value: -1.0 Max value: 1.0 
This is the mix between the original and pitch-shifted signals. 
Menus 
type For now, there is only one type of pitch shifting - Normal. (We wouldn’t 
call it “Abnormal,” would we?) 
interpolate Interpolation improves the smoothness of the table, and thus also the 
quality of the audio. 
None. No interpolation. 
Linear. This is the simplest form of interpolation; it draws a straight 
line between the two points to be interpolated. This is less computa- 
tionally expensive than Quadratic or LaGrange3 (below). 
Constants 
predelay Min value: 10 Max value: limited by available memory 
This set the delay, in milliseconds, before the signal is output. It must be 
set to 10 ms. or greater. 
delay Min value: 10 Max value: limited by available memory 
This is the amount of delay memory used by the pitch shifter. 
taps Min value: 1 Max value: limited by available memory 


This is the number of taps off of the delay line used by the shifter. More 
taps produces smoother pitch shifting (in theory), at the expense of 
code size. 


Version 4.0, January 2000 18| 


Polynomial 


Ports 


name 


input 
output 


weight (n) 


"make big hairy math things" 
-A."M.o.S" Leary 


The Polynomial block implements simple polynomials of the form 
weight1 + weight2*x + weight3*x*x +... 


Growing creates additional weights. 


Any name you like; any name at all. 

Min value: -1.0 Max value: +1.0 

This is the default value for the input port. 
Min value: -1.0 Max value: +1.0 


This is the default value for the output port. 


Min value: -1.0 Max value: +1.0 


The weight of factor (n). 
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create a reed model 


sal 


Ports 


name 


input, output 


breath 


threshold 
scale 


crossfade 


Reed 


The Reed block may be used, in conjunction with a cylinder / junction 
system, to create a model of a single-reed woodwind instrument. 


This block cannot be grown. 


Name this block as you wish. How about Rex? 
Min value: -1.0 Max value: +1.0 


These are the default values for the input and output audio ports. 


Min value: -1.0 Max value: +1.0 


This is the default value for the breath modulation port. The modula- 
tion source (either a continuous controller or an envelope) connected to 
this port is analogous to the strength of breath into a wind instrument; 
this is roughly equivalent to volume. 


Min value: -1.0 Max value: +1.0 


This is the point at which the reed function begins its slope (see the dia- 
gram below). 


Min value: 0.0 Max value: +1.0 


This sets the length of the slope for the reed function (see the diagram 
below). 


Min value: 0.0 Max value: +1.0 
Eventually, this will allow you to crossfade between functions 1 and 2 


in real time. For now, it doesn’t work. 


Reed Function Diagram 


shape of 
slope is 
determined 
by “function” 


threshold 
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Reed 


Menus 


reed 


function | 


function2 


create a reed model 


These menus don’t match the block as it is now. 
The current menus are .... 
‘shape’ with choices ‘Rectangular’, ‘Ellipse’ and ‘Random’ 


‘input interp’ with choices ‘None’, ‘None Host’, ‘Linear’, 
‘Linear Host’ 


‘output interp’ with choices ‘None’, ‘None Host’, ‘Linear’, 
‘Linear Host’, “Allpass’, “Allpass Host’, ‘LaGrange3’, 
‘LaGrange3 Host’, ‘Fast Linear’, ‘Fast Linear Host’, ‘Fast 
Allpass’, ‘Fast Allpass Host’. 


ANDY WILL CHECK 


Normal. Only one choice here, for now. 
This controls the slope of the function for the reed block (see diagram). 


For the quadratic and S-curve functions, see the Reed Function Slope 
Diagrams below (a picture is more eloquent here). 


Linear. This is a simple, straight line. 
Quadratic Up. See diagram below. 
Quadratic Down. See diagram below. 
S Up. See diagram below. 

S Down. See diagram below. 


This does not work yet. Eventually, you will be able to use the crossfade 
parameter to fade between functions 1 and 2 in real time. 


For the quadratic and S-curve functions, see the Reed Function Slope 
Diagrams below (as the old saying goes, PICT > 1 kword). 


Linear. This is a simple, straight line. 
Quadratic Up. See diagram below. 
Quadratic Down. See diagram below. 
S Up. See diagram below. 

S Down. See diagram below. 


Since the menus have changed, the diagrams below must 
be different now as well. 
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create a reed model 


Constants 
shift 


Reed Block 
Diagram 


Reed 


Reed Function Slope Diagrams 


Quadratic Up 


Quadratic Down 


Min value:0 Max value: +e° 


This is a factor-of-two multiplier for the scale parameter, which sets the 
length of the slope. This allows you to fake the program into creating 
scales greater than one. 


Breath 
2 


(+) ——> 
fam > 6 


—_ 


on 
+ 
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Reed Table 


Fadl 


Ports 


name 


input, output 


breath 


select 


position 


Menus 


reed 


interpolate 


multitable (n) 


create a reed model, 
using a table 


The Reed Table block may be used, in conjunction with a cylinder / 
junction system, to create a model of a single-reed woodwind instru- 
ment. As always, be judicious in your use of table-based blocks. 


Name this block as you wish. How about Rex? 
Min value: -1.0 Max value: +1.0 


These are the default values for the input and output audio ports. 


Min value: -1.0 Max value: +1.0 


This is the default value for the breath modulation port. The modula- 
tion source (either a continuous controller or an envelope) connected to 
this port is analogous to the strength of breath into a wind instrument; 
this is roughly equivalent to volume. 


Min value:0 Max value: +ce° 


The Reed Table block can only actually use a single multitable at a time. 
However, you can use the grow command to add more multitables, 
which appear as multitable 1, multitable 2, etc.; this parameter then 
allows you to select between them. 


Multitables cannot be selected in real time on the Macintosh host. How- 
ever, you can use the position port (below) in real time to select 
between the tables contained in a multitable. 


Min value: 0.0 Max value: +1.0 


This selects the table to be used from the current multitable (based on 
key position, for instance). 


This is the type of reed. There is currently only a single choice here. 


Normal. This is the standard reed type. Please to choose. Don’t worry, 
you'll like it. 


Interpolation improves the smoothness of the table, and thus also the 
quality of the audio. 


None. No interpolation. 


Linear. This is the simplest form of interpolation; it draws a straight 
line between the two points to be interpolated. This is less computa- 
tionally expensive than Quadratic or LaGrange3 (below). 


New selection: ‘Linear wrap around’ 


This selects the multitable to be used by the reed. Use the Grow com- 
mand to add more multitables. 
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a simpler junction 


Ports 


name 


junction 


input (n), output (Nn) 


reflection (n) 


Reflection 


The Reflection block is very similar to the Junction block, and can be 
used in its place. Instead of controlling the admittance of its inputs, 
however, the Reflection block specifies a reflection amount. The higher 
the reflection amount, the less of the signal will be passed on to other 
blocks connected to the Reflection block. 


This block avoids the admittance calculations required by the Junction 
block, which require a divide on the host. 


The Reflection block can be grown in a single dimension, “input.” This 
will add additional input, output, and reflection ports. 


For information on the Junction block, see page 150. 


Use any name you choose. 
Min value: 0.0 Max value: +1.0 


This sets the admittance for the Reflection block as a whole. A value of 
0.0 means that the Reflection has an infinite impedance, reflecting sig- 
nals with a -1; a setting of 1.0 has no effect. 


Min value: -1.0 Max value: +1.0 
These are the default values for the input and output(n) audio ports. 
Min value: 0.0 Max value: +1.0 


This sets the reflection for input and output ports (n). The greater this 
value is, the less the input interacts with the other blocks connected to 
the Reflection block. 


Reflection Block Diagram (for 2 inputs) 


1) —P Output 2 
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Rom 


Ports 


name 


select 


store, recall, and crossfade 
multiple sets of values 


The Rom block is used to fade between two or more tables. 


Connecting a selector to the rom ports of the rom block will bring the 
names of the individual tables to the control panel selector. Note: this 
allows you to select between tables in real time. 


Note also that the Rom dsp now works on dsp or host. 


Previously, the rom dsp block output was calculated (mixed) on the 
host and then immediately written down to the dsp. You could not do 
audio rate mixing, although it was a dsp block. As such, you then 
needed a bunch of lowpass filters on the dsp to smooth out the rom out- 
put. 


Now, you can specify that the mixing be done on the dsp. This is done 
with the calculation menu for the block. Set it to “dsp.” Other settings 
will do the mixing on the host, as above. There are some trade-offs; now 
the memory size in the dsp is larger, but you will not need as many 
lowpass filters - you might only need them for the mix inputs. 


Rom Block Example 


You can use the Rom block to fade between the vowels “eee” and “aah” 
in a lattice-based vocal model. Start by determining the reflection 
amounts for each segment of the Lattice block for each of the two vowel 
sounds. Then, create a short table for each vowel sound, with a point in 
the table for each reflection amount. Combine the two tables into a mul- 
titable, and then select this multitable in the Rom block. 


Grow the outputs of the Rom block until there are as many as there are 
stages in the Lattice filter, and connect these to the reflection inputs of 
the Lattice block. Also, grow another mix port, so that there are two - 
one for each vowel sound. In the Rom block, enter 0 for the port rom 1, 
and 1 for the port rom 2 - this selects tables 1 and 2, respectively. 


The ports mix 1 and mix 2 control the relative levels of the tables 
selected by rom 1 and rom 2. To fade between the two tables, connect a 
slider to mix 1, run the slider through a Math block using the function 
1-A, and connect the output of the Math block to mix 2. 


Now, as you move the slider up on the control panel, the output of table 
0 will increase and the output of table1 will decrease; when the slider is 
at 0, only table 1 will be output, and when it is at 1, only table 0 will be 
output. In between, the rom block will interpolate between the two val- 
ues. The reflection amounts of the Lattice filter will then fade between 
“eee” and “aah.” 


Name this block anything you like. 
Min value: 0 Max value: +e 


The Rom block can only actually use a single multitable at a time. How- 
ever, you can use the grow command to add more multitables, which 
appear as multitable 1, multitable 2, etc.; this parameter then allows 


188 


Version 4.0, January 2000 


store, recall, and crossfade 


multiple sets of values 


rom (n) 
mix (Nn) 


output (n) 


Menus 


multitable (n) 


Grow Options 


rom 
output 
table 


Rom 


you to select between them. 


Multitables cannot be selected in real time on the Macintosh host. How- 
ever, you can use the rom port (below) in real time to select between the 
tables contained in a multitable. 


Min value:0 Max value: +ce° 
This selects the table to be controlled by mix port (n). 
Min value: -1.0 Max value: +1.0 


This is the output level of the table selected by rom 1. 


Min value: -1.0 Max value: +1.0 


This is the default value for output port (n). There should be as many 
output ports as there are parameters controlled by the Rom block - e.g., 
to control a 10-stage Lattice block, you would need 10 outputs. 


This selects the multitable to be used by the rom block. Use the grow 
command to add more multitables. 


Adds another pair of rom and mix ports. 
Adds another output port. 
Adds another multitable. 
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Router 


Grow Options 
input 


select 


multiplexer/demultiplexer 


The Router block is a multiplexer; each output has a selector which can 
grab any of the inputs. 


Routers are also a good way to do quick-and-dirty rom blocks, without 
using a table. To do this, enter the desired values into the Router’s input 
ports, and then use a Selector to change between them. 


Connecting a Selector block to a Router’s select port will bring up a dia- 
log box, asking whether you'd like to update the Selector’s labels on the 
Control Panel. 


Name this block anything you like. 

Min value: -1.0 Max value: +1.0 

This is input (n) to the router. 

Min value: 0Max value: (number of input ports)-1 


This selects the input routed to output (n). 


Min value: -1.0 Max value: +1.0 


This is output (n) from the router. Use the corresponding select port to 
connect an input to the output. 


Adds another input port. 


Adds another pair of select and output ports. The select chooses the 
input to be routed to the output. 
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play sampled audio 


Ports 


name 


reset 


phase 


select 


Sample 


The sample block allows you to use audio samples with SynthKit. A 
number of common formats are supported. 


Right now this includes Sound Designer I, II and Sample 
Cell. 


The sample block will be working almost the same as far as 
the interface goes... what will change is that we will be able 
to specify the multisample used in each multisample slot, 
say by clicking in the catalog from the PCI editor, or by 
clicking in a control panel item for the sample block when 
running in synthkit. 


The playback currently always uses a single loop. 


Most of the parameters on the Sample block are intended as outputs for 
other blocks. Playing a specified sample within a multisample could 
thus, for instance, change the cutoff of a filter block; in this way, sam- 
ples can contain some of their own voicing parameters. 


Stereo samples are handled just like mono samples; simply grow the 
sample block for two outputs. The internals are set up to support two or 
more phase-coherent samples for other blocks. 


The Sample block loops override the loops specified in the sample edi- 
tor. 


Give the block any name you wish. Joe, for instance. 
Min value:0 Max value: 1 


Starts the sample. This can be either a host or dsp enumerated port, 
allowing the sample to be reset from the dsp directly. 


Min value: -1.0 Max value: 1.0 


This is not implemented yet, but will be used for start-point modula- 
tion. The attack parameter (below) sets the maximum range of modula- 
tion. A phase value of 1.0 will make the sample start at the sample set 
by the attack parameter; at a phase of 0.5, the sample will start at half 
the number of samples; at a phase of 0.0, the sample will start at the 
beginning. 

Min value:0 Max value: +0 

The Sample block can only actually use a single multisample at a time. 
However, you can use the grow command to add more multisamples, 


which appear as multisample 1, multisample 2, etc.; this parameter 
then allows you to select between them. 


Multisamples cannot be selected in real time on the Macintosh host. 
However, you can use the position port (below) in real time to select 
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Sample 


position 


frequency 


loop 


level 


filter 


pan 


decay 


output 


Menus 


interpolation 


play sampled audio 


between the samples contained in a multisample. 
Min value: 0.0 Max value: +1.0 


This selects the table to be used from the current multisample (based on 
key position, for instance). 


Min value: 0.0 Hz Max value: 24000.0 Hz (1/2 sample rate) 


This sets the frequency at which the sample is played back. Its input 
should be Note, processed through the cExponentialNote table.1. 


Min value:0 Max value: +e° 


This isn’t working yet. The multisample will contain multiple points; 
you will be able to choose which one to use. 


Min value: -1.0 Max value: +1.0 


This is intended as an output to a mixer block; it will transmit the level 
value programmed for the currently selected sample. This does not 
affect the Sample block itself. It can be placed on either the host or the 
dsp. 

Min value: -1.0 Max value: +1.0 


This is intended to feed a filter block; it will transmit the filter value 
programmed for the currently selected sample. This does not affect the 
Sample block itself. It can be placed on either the host or the dsp. 


Min value: -1.0 Max value: +1.0 


This is intended to feed a mixer block; it will transmit the pan value 
programmed for the currently selected sample. This does not affect the 
Sample block itself. It can be placed on either the host or the dsp. 


Min value: 0.0 Max value: +1.0 


This is intended to feed an envelope block; it will transmit the decay 
value programmed for the currently selected sample. This does not 
affect the Sample block itself. It can be placed on either the host or the 
dsp. 


Min value: -1.0 Max value: +1.0 


This is the output of the sample block. 


Interpolation improves the smoothness of the sample playback, and 
thus also the quality of the audio. 


None. No interpolation. 


Linear. This is the simplest form of interpolation; it draws a straight 
line between the two points to be interpolated. This is less computa- 
tionally expensive than Quadratic, LaGrange3, or TG92 (below). 


Quadratic. This doesn’t work for now. 


LaGrange 3. This interpolation method uses three points for the inter- 
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play sampled audio 


direction 


loop 


multisample (n) 


Constants 


attack 


Grow Options 


output 


sample 


Sample 


polation, and is thus more computationally expensive than linear. The 
frequency response is better than linear, but still not perfect. 


This determines whether the sample is played forward, backwards, or 
back and forth. 


Forward. The sample is played forward - the usual choice. 
Backward. The sample is played backwards. 


Forward & Backward. The sample is played forward and backward 
continuously. 


This determines the direction of the loop, independently from the play- 
back of the beginning of the sample (as set above). 


None. The sample is not looped. 
Forward. The loop is played forward - the usual choice. 
Backward. The loop is played backwards. 


Forward & Backward. The loop is played forward and backward con- 
tinuously. 


This selects the multisample to be used by the Sample block. Use the 
grow command to add more multisamples. 


Is Attack implemented? NO 


This is not currently implemented, but it will set the range that can be 
used for start-point modulation, in number of samples. For instance, if 
this is set to 1000, you can start anywhere from sample 1 to sample 
1000. 


Start-point modulation will be done by using the phase port, as 
described above. 


This adds more outputs - for instance, you will need two outputs for a 
stereo sample. 


This adds additional multisamples. 
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Ports 


name 


input 


output 


hold 


Sample and Hold sample and hold 


The Sample and Hold block grabs and holds a signal when it receives a 
trigger. 


You can use an Oscillator along with a Zero Crossing block (or, eventu- 
ally, just a Sequencer block) as the trigger source for a sample-and-hold 
Ifo. 


Give the block any name you wish. 
Min value: -1.0 Max value: +1.0 


This is the input to the sample and hold. 


Min value: -1.0 Max value: +1.0 


This contains the currently “held” signal. 


Min value:0 Max value: 1 


This is a trigger input (0 or 1). When a 1 is received, the signal at the 
input is held, and will be present at the output until the next trigger is 
received. 0 is no hold, 1 is hold; you don’t need to send a 0 before the 
next 1. 
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use a Slider to enter 


discrete values 


Ports 


name 


output 


label (n) 


Grow Options 


output 


label 


Selector 


The Selector block uses a graphic slider to send modulation data. It is 
intended to be used to create control panel interfaces for easy modifica- 
tion of specific parameters in SynthKit patches. 


Select any name that you like. It’s probably best to make this a descrip- 
tion of the characteristic which the Selector is modulating, since this 
name will identify the Selector in the Control Panel. 


Min value: 0 Max value: +00 
This displays the current value of the slider. 


Each state of the Selector may have its own label. This is the label for 
state (n). 

If the Selector is hooked up to a table/sample select port, it will read all 
the multitable / sample names for its labels. If it is connected to a rom 
port, it will display the table names from the multitable. When con- 
nected to a router block, it will display the numbers of each input. You 
can then modify the labels as you see fit. 


Adds another output. 
Adds another label. 
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Shelf 


Fa 


Ports 


name 


input 


frequency 


gain 


Menu 
shelf 


shelving eq 


The Shelf block provides simple shelving eq. The shelf can be set to 
affect frequencies either above or below a programmable (and modulat- 
able) breakpoint. 


Name this block as you see fit. 

Min value: -1.0 Max value: +1.0 

This is the input to the shelving eq. 

Min value: 0.0 Hz Max value: 24000.0 Hz (1/2 sample rate) 


This sets the breakpoint frequency of the shelf filter. A value of 1.0 is 
equal to the Nyquist frequency of the DSP sampling rate, as set in the 
Execution window. This means that, if you change the sampling rate, 
you will probably need to change your filter cutoff points as well. 


Min value: 0.0 Max value: +1.0 


This sets the amplitude change for frequencies either below the break- 
point (if the shelf menu is set to Low) or above the breakpoint (if the 
shelf menu is set to High).Values greater than 1 will increase the ampli- 
tude; values less than 1 will decrease it. Note that this value is in stan- 
dard SynthKit amplitude amounts, and not in dB. 


Low. Values below the specified frequency will be affected. 


High. Values above the specified frequency will be affected 
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create sliders 
for the control panel 


Ports 


name 


output (n) 


Grow Options 


output 


Slider 


When a Slider block is placed in an algorithm, a corresponding slider 
appears on the Control Panel. This allows real-time control of the ports 
connected to the slider. 


Slider Calculation Must Match Block Processing 


The processing rate set in the Slider block’s Calculation menu must 
match the rate set in the Type menu (not the Calculation menu) of the 
block to which it is connected. This will ensure that the numerical for- 
mats of the slider and the block match up (so that Hertz displays cor- 
rectly as Hertz, for instance). 


Use this field to enter a description of the characteristic which the Slider 
is modulating. This name will identify the Slider in the Control Panel. 


Min value: -1.0 Max value: +1.0 


This displays the current value of the Slider. 


Depending on the name type set in the control panel for the 
slider, the example below would be Fred A, Fred B... or 
Fred L, Fred R. Grow is limited to 2 controls. 


How does the name type affect this? 
GROWN SLIDERS SUPPORTED IN OASYS PCI? VERIFY 


Adds more outputs to the Slider block. For each output, a separate 
slider will appear on the control panel, with the same min and max set- 
tings. Each of the sliders will also share the same base name; for 
instance, if the slider block were named “Fred,” then the multiple slid- 
ers on the Control Panel would be named Fred 1, Fred 2, Fred 3, and so 
on. 


Note that although they share the same Slider block, the individual 
sliders on the Control Panel all have their own values; they are not tied 
together in any way. 


You might use this feature for controlling the multiple stages of an 
Envelope or Tube block, for example. 
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u 


Ports 


name 


output 


Menus 


receive 


System Receive route MIDI modulation 


The System Receive Block is used to route MIDI modulation within 
SynthKit. 


For a receive to work in the expected manner, it should usually be num- 
bered before whatever is connected to it (an envelope, for example). 


System Receive controls will be added automatically to the control 
panel if the Preferences->Control Panel “Insert System Blocks” option 
is enabled. 


If this option is not enabled, you can still add individual System 
Receive blocks to the control panel via the “Add To Control Panel” 
command in the Block menu. 


The output port of the System Receive can be set to either Continuous 
or Enumerated; for MIDI inputs especially, this is an important distinc- 
tion. If it is set to Enumerated, then the output is equal to the raw MIDI 
values (0-127); when set to Continuous, it is converted to the usual Syn- 
thKit range of 0-1 


Name the block as you like. 
Min value: -1.0 Max value: +1.0 


This is the default value for the output port. 


There are a few more entries on this menu now. In particu- 
lar ‘None’ and ‘MIDI A’ through ‘MIDI H, ‘Start /Stop’, etc. 


This is the name of the MIDI controller or other signal received by the 
block. Clicking brings up a menu of choices. 


Note. This is the standard pitch input. In most cases, after all desired 
controllers have been merged with the note linear data, the result 
should be sent through one of the constant exponential tables before 
being used (cExponential Note for oscillators, filters, etc., 
cExpLength2000 for Cylinders etc., and for delay line-type blocks, 
cExpLength1000), and then routed to the frequency input. 


Gate. This sends out a 1 as long as a key is held down, and a 0 when it 
is released. In general, Sustain Gate (below) should be used instead. 


Sustain Gate. This provides the normal note-on, note-off function, and 
pays attention to both the state of the keyboard and the state of the sus- 
tain pedal. It is set to 1 is sent as long as a key is held down, or as long 
as the sustain pedal is down; it only goes to 0 when both note and pedal 
are released. In general, this is the best source for note gates, for trigger- 
ing oscillators, envelopes, etc. In the legato modes, Note will still 
change for every new pitch, but Gate and Sustain Gate only retrigger 
for new phrases. 


Velocity. Key-down velocity. 
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System Receive 


Release Velocity. Key up velocity. 


Pitchbend. This receives the MIDI pitch bend control. Normally, it 
should be merged with Note through a mixer, and then the combined 
signal processed through an exponential table. 


Aftertouch. Channel Aftertouch. 

Program Change. MIDI Program Change. 

Mod Wheel. MIDI Mod Wheel (Controller #1). 

Breath Control. MIDI Breath Control (Controller #2). 

Foot Control. MIDI Foot Controller (Controller #4). 

Portamento. MIDI Portamento Controller (Controller #5). 

Data Entry. MIDI Data Controller (Controller #6). 

Volume. MIDI Volume (Controller #7). 

Joystick X. This receives the X-axis of the Wavestation joystick (Con- 
troller #16). 

Joystick Y. This is the Y-axis of the Wavestation joystick (Controller 
#17), 


Sustain. This is the MIDI Sustain Pedal (Controller #64). In most cases, 
for simple note on/off functions, you should use the Sustain Gate 
instead. For use with the Korg FC1, controller #66 is also routed to Sus- 
tain. 


Button 1. This is Button 1 from the Controller Tools window. 
Button 2. This is Button 2 from the Controller Tools window. 


Tempo. This receives MIDI Clocks. An output of 0.0 is equal to 0 bpm, 
and output of 1.0 is equal to 250 bpm. The receive should not be host 
synchronous (that is, should be dsp or host demand). Note that this 
receives MIDI Clocks only, and not MIDI Time Code. 


Patch Settings 


All of the selections below (except for Interrupt) receive their values 
from the Patch settings. These are from either the Patch window, or, if 
the Receive is contained within a Patch block, from the Patch block 
parameters. 


All of these receive types will allow host control of basic voice settings, 
such as might happen within a dedicated hardware instrument (not 
that we have any specific plans for one, or anything). Having these 
items as specific, user-positioned Receives allows the programmer to 
decide what “master volume,” for instance, means for a specific algo- 
rithm. 


Number of Voices. This can be enumerated or continuous. For continu- 
ous, the value output is number of notes /max number of voices, so it 
could be greater than 1.0 for legato voices. 


Amplitude. This is the Amplitude setting from the Patch; you can use 
this to scale the algorithm’s master volume. 
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Transpose. This is the Transpose setting from the Patch; you can use 
this to control the algorithm’s tuning. 


Fine. This is the Fine Tuning from the Patch; like Transpose above, it 
allows the host to control the algorithm’s tuning. 


Note Low. This is for future host key/ velocity zones settings. 
Note High. This is for future host key / velocity zones settings. 
Velocity Low. This is for future host key / velocity zones settings. 
Velocity High.This is for future host key/ velocity zones settings. 


Pitchbend Amount. This is the Patch’s Pitchbend Amount; you might 
use this to control the amount of Pitchbend merged into Note. 


Mono Poly. This turns the receive into a classic Korg analog synth. No, 
just kidding. This is meant to receive voice assignment instruction from 
the host. 


Interrupt. This may be used for future systems. Loose lips sink chips. 
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audio or controllers 


Ports 


name 


input 


output 


select 


position 


level 


Menus 


interpolate 


Table 


The Table block allows you to process audio or controllers through a 
multitable. Tables can be useful, but they take up valuable memory 
(especially when used on the dsp), so try not to use too many of them. 
In many cases, you may be able to duplicate the effects of a Table by 
using the Tracking, Math, or Polynomial blocks. 


Tables and MultiTables are not contained within the Table block; it 
merely uses the data from the Tables and MultiTables windows. For 
more information, please see the Table window (on page 88), the Tables 
List window (on page 95), the MultiTable window (on page 75), and the 
MultiTables List window (on page 77). 


Name the block as you like (“kitchen,” for instance). 
Min value: -1.0 Max value: +1.0 


This is the input to the table. 


Min value: -1.0 Max value: +1.0 


This is the output from the table; outputs can be either continuous or 
enumerated. 


Min value:0 Max value: +e° 


The Table block can only actually use a single multitable at a time. 
However, you can use the grow command to add more multitables, 
which appear as multitable 1, multitable 2, etc.; this parameter then 
allows you to select between them. 


Multitables cannot be selected in real time on the Macintosh host. How- 
ever, you can use the position port (below) in real time to select 
between the tables contained in a multitable. 


Min value: 0.0 Max value: +1.0 


This selects the table to be used from the current multitable (based on 
key position, for instance). 


Min value: -1.0 Max value: +1.0 


This has no effect on the table output per se. It sends out the level 
amount programmed for the selected table in the multitable, and is 
intended to feed a mixer block. This is similar to the level port in the 
Sample block. 


Interpolation improves the smoothness of the table, and thus also the 
quality of the audio. 


None. No interpolation. 


Linear. This is the simplest form of interpolation; it draws a straight 
line between the two points to be interpolated. This is less computa- 
tionally expensive than Quadratic or LaGrange3 (below). 
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multitable (n) 


Grow Options 


table 


use a multitable to process 
audio or controllers 


Qudratic and LaGrange3 are replaced by ‘Linear wrap 
around’. 


Quadratic. This doesn’t work for now. 


LaGrange 3. This interpolation method uses three points for the inter- 
polation. The frequency response is better than linear, but still not per- 
fect. LaGrange 3 is the most computationally expensive interpolation 
method. 


A new menu is between the ‘interpolate’ and the ‘multi- 
table’ menu. It is called ‘polarity’. The choices are... 


‘Bipolar’ - this is the normal table lookup where input val- 
ues from -1 to 1 are mapped into indexes into the table. 


‘Unipolar’ - in this mode, input values from 0 to 1 are 
mapped into indexes into the table. Any input value less 
than 0 is treated as 0. It is a ‘one sided’ table. 


‘Symmetric’ - In this mode, the absolute value of the input 
is used to find the index of the table, which means that the 
graph of the output is symmetric around the y-axis. 


‘Symmetric Odd’ - this is like ‘Symmetric’ but the sign of 
the input is multiplied by the output. A symmetric odd 
function satisfies f(x) = -f(x) and that’s just what this table 
mode does. 


‘Periodic’ - this is the last of the ‘one sided’ table interpreta- 
tions. One is added to the input if it is less than zero, so the 
value used to find the index into the table is always 
between 0 and 1. It is periodic because the values output 
from inputs of -1 to -0 repeat with inputs from 0 to 1. 


This selects the multitable to be used. Click on the word “multitable” to 
open the Multitable window; command-click to open a specific table. 


Select the option “New...” to create a new multitable. 


Adds another multitable. 
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Ports 


name 


input 


output (n) 


Grow Options 


output 


Tap 


The Tap block creates a number of single-sample delays, to be used for 
dispersion. Each delay has its own output. By using a Tap in conjunc- 
tion with a mixer and varying the number and relative volumes of the 
delays, it is possible to create complex filters, such as FIRs. 


For the default DSP frequency of 44.1 kHz, a single-sample delay is 
equal to 22.675 microseconds. 


Name the block as you like. 
Min value: -1.0 Max value: +1.0 


This is the input to the block. 


Min value: -1.0 Max value: +1.0 


This is the output of delay (n-1); the first output has no delay. For 
instance, output 4 will have a 3-sample delay. 


Adds another output, along with another single-sample delay. 
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Threshold 


Ports 


name 


input 
output 
threshold (n) 


Grow Options 


threshold 


send out a trigger when input 
reaches a certain level 


The Threshold block sends out triggers based on the level of its input 
signal. This can be used for amplitude-controlled functions, specific 
quantization of controllers, and so on. 


While the signal is less than threshold 1, the output is 0; at threshold 1, 
the output becomes 1; at threshold 2, the output becomes 2, and so on. 


Give this block any name you like. 

Min value: -1.0 Max value: +1.0 

This is the audio input port. 

Min value: 0 Max value: number of thresholds 


This sends out a trigger, with the current threshold value. 


Min value: -1.0 Max value: +1.0 


This sets the value for threshold (n). 


Adds another threshold port. 
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the table-less table 


Ports 


name 


input 

output 
breakpoint (n) 
value (n) 


Menu 


type 


extrapolate 


Grow Options 


breakpoint 


Tracking 


The Tracking block allows you to specify breakpoints for a pseudo- 
table lookup function. You might, for instance, set 5 breakpoints for the 
entire range of -1.0 to +1.0; values between two of these breakpoints are 
interpolated. 


This function is calculated, rather than stored as a table, which allows 
you to modulate the breakpoints in real time. The number of break- 
points can be grown. 


Give this block any name you like. 

Min value: -1.0 Max value: +1.0 

This is the input to the Tracking Generator. 

Min value: -1.0 Max value: +1.0 

This is the output from the Tracking Generator function. 
Min value: -1.0 Max value: +1.0 


This is the input value which will result in value (n), below. 


Min value: -1.0 Max value: +1.0 


This is the output value corresponding to breakpoint (n). 


This sets the interpolation between the breakpoints; as elsewhere, the 
better the interpolation, the more computationally expensive the block 
becomes. 


None. No interpolation between breakpoints, resulting in stepped out- 
put. 


Linear. The breakpoints are connected by straight lines. 


Quadratic. The breakpoints are connected by curved lines, derived 
from the three closest breakpoint values. 


If the input value is outside the range of the breakpoints (less than the 
first breakpoint or greater than the last breakpoint), this parameter 
determines how the output is computed. 


False. The output is the value of the closest breakpoint - either the first 
value for inputs which are too low, or the last value for those which are 


too high. 


True. The curve of the Tracking block will be extended past the first and 
last breakpoints, using the interpolation set above (so, if the interpola- 
tion type is None, then extrapolation will not have any effect). 


Adds another pair of breakpoint and value ports. 
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Ports 


name 


input left, input right 


output left, output right 


ratio 


addin ratio (n) 


addin (n) 


pressure ratio (n) 


pressure (n) 


admittance 0 


adm ratio(n) 


create an efficient series of 


Tube Admittance multiple cylinders 


The Tube Admittance block is a string of cylinders and junctions 
arranged one after another; each cylinder and junction pair is a segment 
of the tube. The admittance of each segment may be thought of as its 
diameter; by stringing together several tube segments of different 
admittances, you can simulate tubes of different shapes (such as an out- 
ward expanding bell, for instance). The Tube blocks are much more effi- 
cient than using separate Cylinder and Junction blocks. 


Compared to the Tube Reflection block, the Tube Admittance block is 
more intuitive to edit, but significantly less efficient to modulate in real 
time (more host processing is necessary). Both Tube blocks produce the 
same dsp code; the only difference is in the parameters provided. 


You can use the Control Panel’s Size Meter for a graphic display of the 
tube segments. 


Use any name you choose. 
Min value: -1.0 Max value: +1.0 


These are the default values for the input audio ports. 


Min value: -1.0 Max value: +1.0 


These are the default values for the output audio ports. 


Min value: 0.0 Max value: +1.0 


This is the total length of the Tube; a value of 1.0 makes the length equal 
to the constant parameter, “delay” (set below). The ratio port expects 
Note input, processed through the cExpLength2000 table. 


Min value: 0.0 Max value: +1.0 


This determines the position of addin (n) within the tube; addins can be 
at any position, and don’t need to fall exactly on a segment boundary. 
The value of this parameter is an arbitrary number, such that 1.0 is 
equal to the total length of the Tube. 


Min value: -1.0 Max value: +1.0 
This is the addin port for segment (n). 
Min value: 0.0 Max value: +1.0 


This determines the position of pressure output (n) within the tube; the 
value is an arbitrary number, such that 1.0 is equal to the total length of 
the Tube. Use this to make a tap out of the Tube from a specific position; 
as with the addin ratio, this does not need to correspond to a segment 
boundary. 


Min value: -1.0 Max value: +1.0 


This is the output port for segment (n). 


Min value: -1.0 Max value: +1.0 


This is the admittance of the first segment of the tube. 


Min value:0 Max value: +1.0 
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create an efficient series of 
multiple cylinders 


admittance (n) 


Menus 


length interp 


addin interp (n) 


pressure interp (n) 


Tube Admittance 


This determines the position of the beginning of segment (n) within the 
Tube; it is an arbitrary number, such that 1.0 is equal to the Tube’s total 
length. To add more segments, grow more adm ratios. 


Min value: -1.0 Max value: +1.0 


This is the admission of segment (n). 


Interpolation improves the quality of the audio. There are several basic 
types of interpolation, each of which can be performed entirely on the 
dsp or with the assistance of the host. Using host-assisted interpolation 
frees up some Dsp code space. 


This is the interpolation for the master ratio input. 
None. No interpolation. 


None Host. No interpolation, but the host helps out by calculating off- 
set. 


Linear. This uses simple straight-line interpolation. Linear interpolation 
is less computationally expensive than Allpass or LaGrange3 (below). 


Linear Host. Similar to Linear above, but the host calculates offsets and 
interpolation parameters. This is less computationally expensive than 
Allpass or LaGrange3 (below). 


Allpass. This option uses a constant table to provide high-quality all- 
pass filtering. It is somewhat more computation-intensive than Linear 
(above), but provides a flat frequency response. 


Allpass Host. This is the same as Allpass above, except that offsets and 
interpolation parameters are calculated on the host. 


LaGrange 3. This interpolation method uses three points for the inter- 
polation. The frequency response is better than linear, but still not per- 
fect. This is the most computationally expensive interpolation method. 


LaGrange 3 Host. Same as LaGrange 3 above, except that the coeffi- 
cients are calculated on the host. 


This is the interpolation for addin input (n). 
None. No interpolation. 


None Host. No interpolation, but the host helps out by calculating off- 
set. 


Linear. This uses simple straight-line interpolation. 


Linear Host. Similar to Linear above, but the host calculates offsets and 
interpolation parameters. 


This is the interpolation for pressure output (n). 
None. No interpolation. 


None Host. No interpolation, but the host helps out by calculating off- 
set. 
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adm interp (n) 


Constants 
delay 


correction 


create an efficient series of 


Tube Admittance multiple cylinders 


Linear. This uses simple straight-line interpolation. Linear interpolation 
is less computationally expensive than Allpass or LaGrange3 (below). 


Linear Host. Similar to Linear above, but the host calculates offsets and 
interpolation parameters. This is less computationally expensive than 
Allpass or LaGrange3 (below). 


Allpass. This option uses a constant table to provide high-quality all- 
pass filtering. It is somewhat more computation-intensive than Linear 
(above), but provides a flat frequency response. 


Allpass Host. This is the same as Allpass above, except that offsets and 
interpolation parameters are calculated on the host. 


LaGrange 3. This interpolation method uses three points for the inter- 
polation. The frequency response is better than linear, but still not per- 
fect. This is the most computationally expensive interpolation method. 


LaGrange 3 Host. Same as LaGrange 3 above, except that the coeffi- 
cients are calculated on the host. 

Add the four new choices for delay oriented interpolation 
menus. Note that adm interp, below, is not implemented on 
OASYS PCL. 


This is the interpolation for segment (n). 
None. No interpolation. 


None Host. No interpolation, but the host helps out by calculating off- 
set. 


Linear. This uses simple straight-line interpolation. 


Linear Host. Similar to Linear above, but the host calculates offsets and 
interpolation parameters. 


Min value: 0.0 Max value: limited by available memory. 


This sets the maximum length of the Tube, in milliseconds. As with 
other cylinder-based blocks, there are two delay lines of this length, 
going in opposite directions; so, the amount of memory allocated to the 
Tube block is twice this amount. This amount of delay memory is con- 
stantly allocated, regardless of the current ratio (tuning) of the Tube. 


The default value for this parameter is taken from the algorithm’s Exe- 
cution window, which is in turn derived from your Preferences file. If 
you'd like to change this, just go to the Execution page of the Prefer- 
ences dialog. 


For proper tuning at 44.1 kHz, use the default delay length of 22.67574. 
Min value: 0.0 Max value: +9 


This is a pitch-correction option, which can be used to compensate for 
the total delay of a system (in samples). The default value is 0, which 
causes the correction to be optimized out. If you insert a filter into the 
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create an efficient series of 
multiple cylinders 


Grow Options 


addin ratio 
pressure ratio 


adm ratio 


Tube Admittance 


loop, it will introduce a small amount of extra delay, which will affect 
the tuning. To compensate for this, try entering a correction amount of 
0.25, or 0.5. This is a “tweaky” parameter - play with it until it sounds 
right. 


Adds another pair of addin and addin ratio ports, and a corresponding 
addin interpolation menu. 


Adds another pair of pressure and pressure ratio ports, along with a 
corresponding pressure interpolation menu. 


Adds another pair of admission and adm ratio ports, and a correspond- 
ing adm ratio interpolation menu. Each of these sets represents an addi- 
tional segment of the Tube. 
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Tube Reflection 


create an even more efficient 


series of multiple cylinders 


The Tube Reflection block is a string of cylinders and junctions 
arranged one after another; each cylinder and junction pair is a segment 
of the tube. The admittance of each segment can be thought of as its 
diameter; by stringing together several segments of different diameters, 
you can simulate tubes of different shapes (such as an outward expand- 
ing bell, for instance). The Tube blocks are much more efficient than 
using separate Cylinder and Junction blocks. 


Compared to the Tube Admittance block, the Tube Reflection block is 
less intuitive to edit, but much more efficient to modulate in real time 
(less host processing is necessary). Both Tube blocks produce the same 
dsp code; the only differences are in host code and the parameters pro- 
vided. 


In the Tube Reflection block, the shape of the tube is controlled by vary- 
ing the reflection amounts between each pair of segments, instead of 
varying the admittance of each segment. The reflection between two 
segments is relative to their admittances, as shown in the diagram 
below. 


A, is the admittance of segment i 


K, is the reflection between segments i-1 and i 


As the diagram above shows, each reflection amount affects the ratios 
of the admittances of the two adjoining segments. 


To allow each segment to be controlled independently (with all other 
segments remaining the same), the reflections of all segments after the 
adjusted reflection point would need to be scaled to compensate. In the 
diagram above, for instance, increasing K, would decrease Ay; if Ky and 
K3 remain the same, Ay and A3 would then become smaller as well. To 
leave those admittances at their previous levels, the reflections would 
need to be scaled, entailing some amount of additional processing. The 
Tube Admittance block uses additional host code to do this scaling 
automatically. 
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series of multiple cylinders 


Ports 


name 


input left, input right 


output left, output right 


output weight 


ratio 


addin ratio (n) 


addin (n) 


pressure ratio (n) 


pressure (n) 


reflection ratio(n) 


Tube Reflection 


Generally, increasing reflection (n) decreases admittance (n), and vice- 
versa. 


You can use the Control Panel’s Size Meter for a graphic display of the 
tube segments. 


Use any name you choose. 
Min value: -1.0 Max value: +1.0 


These are the default values for the input audio ports. 


Min value: -1.0 Max value: +1.0 


These are the default values for the output audio ports. 


There is no output weight port in the current synthkit. 
Min value: -1.0 Max value: +1.0 


This is the summed output of all of the segments’ individual outputs 
(each segment’s gain into this output is determined by its weight 
parameter). 


Min value: 0.0 Max value: +1.0 


This is the total length of the Tube; 1.0 is equal to the constant parame- 
ter, “delay” (set below). It expects Note input, processed through the 
cExpLength2000 table. 


Min value: 0.0 Max value: +1.0 


This determines the position of addin (n) within the tube; addins can be 
at any position, and don’t need to fall exactly on a segment boundary. 
The value of this parameter is an arbitrary number, such that 1.0 is 
equal to the total length of the Tube. 


Min value: -1.0 Max value: +1.0 
This is the addin port for segment (n). 
Min value: 0.0 Max value: +1.0 


This determines the position of pressure output (n) within the tube; the 
value is an arbitrary number, such that 1.0 is equal to the total length of 
the Tube. Use this to make a tap out of the Tube from a specific position; 
as with the addin ratio, this does not need to correspond to a segment 
boundary. 


Min value: -1.0 Max value: +1.0 
This is the output port for segment (n). 
Min value:0 Max value: +1.0 


This sets the position of reflection (n) within the tube, defining a tube 
segment boundary; the value is an arbitrary number, such that 1.0 is 
equal to the total length of the Tube. As the pitch changes, the tube 
stretches and contracts; the reflection points move as well, retaining 
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Tube Reflection 


reflection (n) 


Menus 


length interp 


addin interp (n) 


pressure interp (n) 


create an even more efficient 
series of multiple cylinders 


their relative positions within the tube. 
Min value: -1.0 Max value: +1.0 


This is the reflection of junction (n). Each junction is a boundary 
between two different segments of the Tube. Negative values mean that 
the next segment is larger than the previous one; positive values mean 
that the next segment is smaller. 


Interpolation improves the quality of the audio. There are several basic 
types of interpolation, each of which can be performed entirely on the 
dsp or with the assistance of the host. Using host-assisted interpolation 
frees up some Dsp code space. 


This is the interpolation for the master ratio input. 
None. No interpolation. 


None Host. No interpolation, but the host helps out by calculating off- 
set. 


Linear. This uses simple straight-line interpolation. Linear interpolation 
is less computationally expensive than Allpass or LaGrange3 (below). 


Linear Host. Similar to Linear above, but the host calculates offsets and 
interpolation parameters. This is less computationally expensive than 
Allpass or LaGrange3 (below). 


Allpass. This option uses a constant table to provide high-quality all- 
pass filtering. It is somewhat more computation-intensive than Linear 
(above), but provides a flat frequency response. 


Allpass Host. This is the same as Allpass above, except that offsets and 
interpolation parameters are calculated on the host. 


LaGrange 3. This interpolation method uses three points for the inter- 
polation. The frequency response is better than linear, but still not per- 
fect. This is the most computationally expensive interpolation method. 


LaGrange 3 Host. Same as LaGrange 3 above, except that the coeffi- 
cients are calculated on the host. 


add the four menu items ‘Fast Linear’, ‘Fast Linear Host’, 
‘Fast Allpass’, ‘Fast Allpass Host’. 

This is the interpolation for addin input (n). 

None. No interpolation. 


None Host. No interpolation, but the host helps out by calculating off- 
set. 


Linear. This uses simple straight-line interpolation. 


Linear Host. Similar to Linear above, but the host calculates offsets and 
interpolation parameters. 


This is the interpolation for pressure output (n). 
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series of multiple cylinders 


refl interp (n) 


Constants 
delay (n) 


Tube Reflection 


None. No interpolation. 


None Host. No interpolation, but the host helps out by calculating off- 
set. 


Linear. This uses simple straight-line interpolation. Linear interpolation 
is less computationally expensive than Allpass or LaGrange3 (below). 


Linear Host. Similar to Linear above, but the host calculates offsets and 
interpolation parameters. This is less computationally expensive than 
Allpass or LaGrange3 (below). 


Allpass. This option uses a constant table to provide high-quality all- 
pass filtering. It is somewhat more computation-intensive than Linear 
(above), but provides a flat frequency response. 


Allpass Host. This is the same as Allpass above, except that offsets and 
interpolation parameters are calculated on the host. 


LaGrange 3. This interpolation method uses three points for the inter- 
polation. The frequency response is better than linear, but still not per- 
fect. This is the most computationally expensive interpolation method. 


LaGrange 3 Host. Same as LaGrange 3 above, except that the coeffi- 
cients are calculated on the host. 


add the four menu items ‘Fast Linear’, ‘Fast Linear Host’, 
‘Fast Allpass’, ‘Fast Allpass Host’. 


This is the interpolation for reflection (n). Interpolation of reflections 
helps the timbre to remain constant from note to note. 


None. No interpolation. 


None Host. No interpolation, but the host helps out by calculating off- 
set. 


Linear. This uses simple straight-line interpolation. 


Linear Host. Similar to Linear above, but the host calculates offsets and 
interpolation parameters. 


Min value: 0.0 Max value: limited by available memory. 


This sets the maximum length of the Tube, in milliseconds. As with 
other cylinder-based blocks, there are two delay lines of this length, 
going in opposite directions; so, the amount of memory allocated to the 
Tube block is twice this amount. This amount of delay memory is con- 
stantly allocated, regardless of the current ratio (tuning) of the Tube. 


The default value for this parameter is taken from the algorithm’s Exe- 
cution window, which is in turn derived from your Preferences file. If 
you'd like to change this, just go to the Execution page of the Prefer- 
ences dialog. 


For proper tuning at 44.1 kHz, use the default delay length of 22.67574. 
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create an even more efficient 


Tub e Refi ect i on series of multiple cylinders 


correction 


Grow Options 


addin ratio 
pressure ratio 


refl ratio 


Min value: 0.0 Max value: +°e° 


This is a pitch-correction option, which can be used to compensate for 
the total delay of a system (in samples). The default value is 0, which 
causes the correction to be optimized out. If you insert a filter into the 
loop, it will introduce a small amount of extra delay, which will affect 
the tuning. To compensate for this, try entering a correction amount of 
0.25, or 0.5. This is a “tweaky” parameter - play with it until it sounds 
right. 


Adds another pair of addin and addin ratio ports, and a corresponding 
addin interpolation menu. 


Adds another pair of pressure and pressure ratio ports, along with a 
corresponding pressure interpolation menu. 


Adds another pair of reflection and reflection ratio ports, and a corre- 
sponding reflection interpolation menu. Each of these sets represents an 
additional segment of the Tube. 
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create virtual wires 


Menus 


receive 


User Receive 


The User Receive block is used to create virtual wires, in conjunction 
with the User Send Block. You can use this to run signals between sub- 
algorithms, for instance, or to clean up wiring. For MIDI modulation, 
use the System Receive. 


Name the block as you like. 
Min value: -1.0 Max value: +1.0 


This is the default value for the output port. 


This is the name of the bus on which this block receives. 


Clicking on this field brings up a menu of all User Send buses. 
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U ser S en d create virtual wires 


tea The User Send block is used to create virtual wires, in conjunction with 
i the User Receive Block. This allows you to run signals between sub- 
algorithms, for instance, or to clean up wiring. 


Ports 
name This is the name of the bus on which this block will send. 
Once a send has been assigned a bus name, that name will appear at the 
bottom of the name menu in all User Receive blocks. 
input Min value: -1.0 Max value: +1.0 
This is the input to the send - the signal that will be sent (doesn’t that 
sound like the beginning to a bad nursery rhyme?). 
Menus 
send This menu allows you to select the bus on which the input will be sent. 


In the future, you could use a send to poke into a location in an algo- 
rithm and designate it as, for instance, amplitude, for detection by the 
host - similar to a “probe” feature. 
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